GraphQL API that orchestrates compute deployments across decentralized infrastructure, manages custom domains with automatic SSL, serves deployment templates, and powers the AI assistant and feedback system.
Runs on port 1602.
pnpm install
cp .env.example .env
npx prisma migrate dev
pnpm devGraphQL Playground: http://localhost:1602/graphql
- Standard Compute — deploy containers to decentralized infrastructure
- Confidential Compute — hardware-isolated execution environments
- Unified deployment lifecycle: create → deploy → monitor → close
- Self-healing reconciler with strict close-on-
'gone'-only policy and fleet-wide mass-event guards (Phase 49 + 49b — seeadmin/cloud/docs/AF_DEVELOPMENT_PROCESS.md)
- Pre-built deployment templates (GPU instances, game servers, AI agents, etc.)
- Composable multi-service templates
- Template catalog with pricing and resource specs
- Custom domain verification (TXT, CNAME, A record)
- Automatic Let's Encrypt SSL provisioning and renewal
- Subdomain proxy routing (
*.alternatefutures.ai)
- Per-user AI agents with persistent chat history
- Platform-aware assistant with tool access
- ClickHouse integration for traces, logs, and metrics
- Storage usage tracking
| Layer | Tech |
|---|---|
| Runtime | Node.js |
| Framework | GraphQL Yoga |
| Database | PostgreSQL + Prisma |
| Observability | ClickHouse |
| Compute | Decentralized providers (standard + confidential) |
| SSL | Let's Encrypt (ACME) |
| Testing | Vitest |
src/
├── schema/typeDefs.ts # GraphQL schema
├── resolvers/ # Query + mutation resolvers
│ ├── index.ts # Main resolver map
│ ├── akash.ts # Compute deployments
│ ├── domain.ts # Domains + DNS + SSL
│ ├── chat.ts # AI agents + chat
│ └── feedback.ts # Bug reports + feedback
├── services/
│ ├── akash/ # Standard compute orchestration
│ ├── phala/ # Confidential compute integration
│ ├── dns/ # Domain verification + SSL
│ ├── billing/ # Invoice generation
│ ├── chat/ # Agent + chat service
│ └── observability/ # ClickHouse integration
├── templates/definitions/ # Deployment template definitions
└── index.ts # Server entry
See .env.example for the full list. Key variables:
| Variable | Required | Description |
|---|---|---|
DATABASE_URL |
Yes | PostgreSQL connection string |
AUTH_SERVICE_URL |
Yes | URL to service-auth |
AUTH_INTROSPECTION_SECRET |
Yes | Shared secret with service-auth |
AKASH_MNEMONIC |
For compute | Compute provider wallet mnemonic |
CLICKHOUSE_URL |
For observability | ClickHouse connection |
DISCORD_FEEDBACK_WEBHOOK_URL |
For feedback | Discord webhook for bug reports |
pnpm test # Run test suite
pnpm tsc --noEmit # Type check
npx prisma migrate dev # Apply schema changes
npx prisma studio # Browse databasemain— productiondevelop— active development- Feature branches:
feature/ALT-123-description
- service-auth — Auth + billing + AI proxy
- web-app — Dashboard
- alternate-clouds-cli — CLI
AGPL-3.0-only