bluesky-social /atproto

Social networking technology created by Bluesky

★ 9,729⑂ 940👁 107⑃ 3,990● 1,068▤ 3,835
TypeScriptNOASSERTIONCreated 2021-12-17
下载:@atproto/[email protected]@atproto/[email protected] ↓0.7.122026-11-13
+1
日增长
9,729
stars
940
forks
107
watchers
3,990
prs
1,068
issues
3,835
releases

README

AT Protocol Reference Implementation (TypeScript)

Welcome friends!

This repository contains Bluesky's reference implementation of AT Protocol.

 About AT Protocol

The Authenticated Transfer Protocol ("ATP" or "atproto") is a decentralized social media protocol, developed by Bluesky Social PBC. Third-party software can be as seamless as first-party: custom feeds, federated services, and alternative clients are all built against the same APIs, so developers are never locked out of the ecosystems they help build. Learn more at:

- Overview and Guides 👈 Best starting point
- Github Discussions 👈 Great place to ask questions
- Protocol Specifications

The Bluesky Social application encompasses a set of schemas and APIs built in the overall AT Protocol framework. The namespace for these "Lexicons" is app.bsky..

 What is in here?

Lexicons: for the com.atproto. and tools.ozone. namespaces are currently maintained in this repo under the ./lexicons/ directory. These are JSON files in the Lexicon schema definition language, similar to JSON Schema or OpenAPI. Lexicons for the app.bsky. and chat.bsky. namespaces are now maintained in the bluesky-social/bsky git repository, and the copies here may be out of date.

TypeScript Packages: everything under ./packages/ is published to npm under the @atproto/ scope (except for the shared utilities in ./packages/internal/, which use the @atproto-labs/ scope). Each package has its own README; packages/README.md lists them all. The short version, if you're new here:

- Building an app or bot? Start with @atproto/lex — the type-safe SDK that generates TypeScript from Lexicon schemas and gives you an HTTP (XRPC) client. The rest of ./packages/lex/ contains its building blocks (data model, JSON/CBOR encoding, schema validation, server routing), which you rarely need to install directly. The older @atproto/api client still exists and is still used in parts of this repo, but new code should prefer @atproto/lex.
- Adding "Sign in with Atmosphere Account"? The OAuth client and server implementations live in ./packages/oauth/ — pick the client variant matching your runtime (browser, node, expo).
- Implementing atproto itself? The protocol primitives are split into focused packages: identifier parsing (syntax), DID/handle resolution (identity, did), signing (crypto), repository & Merkle Search Tree (repo), and firehose consumption (sync).
- Everything else is either a service implementation (see below), shared internal glue (common, common-web, ./packages/internal/), or dev tooling (dev-env, dev-infra).

TypeScript Services: each has its implementation in packages/ and a thin runtime wrapper in services/. services/README.md explains how to build and run their Docker images.

- pds: "Personal Data Server", hosting repo content for atproto accounts. See bluesky-social/pds for directions on self-hosting.
- bsky: AppView implementation of the app.bsky. API endpoints, including a PostgreSQL dataplane implementation for testing. 

Top issues

Discussions

Latest release

@atproto/[email protected] @atproto/[email protected] 2026-11-13
Patch Changes

- Updated dependencies [156b4a4]:
  - @atproto/[email protected]

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON