Sifa professional network API (Fastify, AT Protocol, Jetstream) sifa.id/
TypeScript 99.6%
JavaScript 0.3%
Dockerfile 0.1%
Other 0.1%
133 1 0

Clone this repository

https://tangled.org/gui.do/sifa-api https://tangled.org/did:plc:45uheisi25szrjvjurfpritx/sifa-api
git@tangled.org:gui.do/sifa-api git@tangled.org:did:plc:45uheisi25szrjvjurfpritx/sifa-api

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md
Sifa Logo

Sifa API#

AT Protocol AppView backend for professional identity -- portable profiles, verifiable track records, no vendor lock-in.

Status: Alpha License: Source Available CI Node.js TypeScript


Overview#

The AppView backend for the Sifa professional network. Handles AT Protocol OAuth authentication, professional profile aggregation via Jetstream, endorsement workflows, and professional graph queries. Reads profile data from users' PDS instances and aggregates it into a searchable professional directory.


Tech Stack#

Component Technology
Runtime Node.js 25 / TypeScript (strict mode)
Framework Fastify 5
Protocol @atproto/api, @atproto/oauth-client-node, Jetstream
Database PostgreSQL 17 (Drizzle ORM, Drizzle Kit migrations)
Cache Valkey 8 (via ioredis)
Validation Zod
Testing Vitest
Logging Pino (structured)

Quick Start#

Prerequisites: Node.js 25+, npm, Docker + Docker Compose, AT Protocol PDS access (Bluesky or self-hosted).

git clone https://github.com/singi-labs/sifa-api.git
cd sifa-api
npm ci

# Start PostgreSQL + Valkey
npm run services:up

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Run database migrations
npm run db:migrate

# Run development server
npm run dev

Development#

npm test           # Run all tests
npm run build      # Compile TypeScript
npm run lint       # ESLint
npm run typecheck  # TypeScript strict mode check
npm run format     # Format with Prettier

See CONTRIBUTING.md for branching strategy, commit format, and code review process.

Key standards:

  • TypeScript strict mode (no any, no @ts-ignore)
  • All endpoints validate input with Zod schemas
  • Conventional commits enforced (type(scope): description)

Repository Description License
sifa-web Frontend (Next.js, React, TailwindCSS) Source-available
sifa-lexicons AT Protocol professional profile schemas MIT
sifa-deploy Docker Compose + Caddy deployment config Source-available
sifa-workspace Project coordination and issue tracking Source-available

Community#


License#

Source-available -- Public repository, proprietary license. Lexicon schemas and import tools are MIT-licensed.

See LICENSE for full terms.


Made with ♥ in 🇪🇺 by Singi Labs