How kingjetkong/puter works
Puter is a self-hostable personal-cloud platform: users access files and apps through its backend, while developers build and publish apps that can use cloud storage, databases, workers, and AI. The graph highlights the request/controller and filesystem stages, plus authentication and AI entry points. Several major capabilities are documented but their runtime wiring was not sampled, so those relationships are left out rather than inferred.
Main entry points: FSController.ts File endpoints · resolveNode.ts Path resolution · UserStore.ts User store · PuterRouter.ts HTTP routing
Components 21
Request and identity
- HTTP routing
src/backend/core/http/PuterRouter.ts - Auth endpoints
src/backend/controllers/auth/AuthController.ts - Authentication
src/backend/services/auth/AuthService.ts - Request actor
src/backend/core/actor.ts - User store
src/backend/stores/user/UserStore.ts
Cloud services
- File endpoints
src/backend/controllers/fs/FSController.ts - Filesystem service
src/backend/services/fs/FSService.ts - Path resolution
src/backend/services/fs/resolveNode.ts - Share path masking
src/backend/services/fs/sharePathMask.ts - File metadata
src/backend/stores/fs/FSEntry.ts - File metadata store
src/backend/stores/fs/FSEntryStore.ts - Object storage
src/backend/stores/fs/S3ObjectStore.ts
Developer platform
- App platform
src/backend/drivers/apps/AppDriver.js - Serverless workers
src/backend/drivers/workers/WorkerDriver.ts - Key-value database
src/backend/drivers/kv/KVStoreDriver.ts - Developer center
src/dev-center/js/apps.js
AI capabilities
- AI endpoints
src/backend/controllers/puterai/PuterAIController.ts - Chat completion
src/backend/drivers/ai-chat/ChatCompletionDriver.ts - Image generation
src/backend/drivers/ai-image/ImageGenerationDriver.ts - Speech services
src/backend/drivers/ai-tts/TTSDriver.ts
Other components
- User
Connections 20
- User → HTTP routing: makes requests
- HTTP routing → Auth endpoints: routes requests
- Auth endpoints → User store: reads accounts
src/backend/controllers/auth/AuthController.ts - Authentication → User store: looks up users
src/backend/services/auth/AuthService.ts - User store → Request actor: provides user rows
src/backend/core/actor.ts - File endpoints → Path resolution: resolves paths
src/backend/controllers/fs/FSController.ts - File endpoints → Share path masking: masks shared paths
src/backend/controllers/fs/FSController.ts - Path resolution → File metadata store: reads entries
src/backend/services/fs/resolveNode.ts - Path resolution → File metadata: uses entry records
src/backend/services/fs/resolveNode.ts - Share path masking → File metadata store: reads entries
src/backend/services/fs/sharePathMask.ts - File endpoints → Filesystem service: moves files
src/backend/controllers/fs/FSController.ts - App platform → User: publishes apps
README.md - Developer center → App platform: builds and publishes
README.md - Serverless workers → User: offers workers
README.md - Key-value database → User: offers app database
README.md - Filesystem service → Object storage: stores file content
- User → AI endpoints: requests AI
README.md - AI endpoints → Chat completion: invokes chat
src/backend/controllers/puterai/PuterAIController.ts - User → Image generation: uses AI creation
README.md - User → Speech services: uses AI services
README.md