How heyputer/puter works
Puter is a self-hostable personal cloud computer and developer platform. A user authenticates, then works with files and apps through the service; developers can also invoke AI, use cloud storage and key-value data, and run serverless workers. The graph combines those documented capabilities with backend components visible in the source index. Several product areas were not sampled, so their internal call relationships are omitted rather than inferred.
Main entry points: FSController.ts File API · AuthController.ts Auth endpoints · PuterAIController.ts AI endpoints · AuthService.ts Authentication
Components 19
Requests and identity
- Auth endpoints
src/backend/controllers/auth/AuthController.ts - Authentication
src/backend/services/auth/AuthService.ts
Cloud workspace
- File API
src/backend/controllers/fs/FSController.ts - Filesystem service
src/backend/services/fs/FSService.ts - File metadata
src/backend/stores/fs/FSEntryStore.ts - Path resolution
src/backend/services/fs/resolveNode.ts - Shared path masking
src/backend/services/fs/sharePathMask.ts - App management
src/backend/services/apps/AppService.ts - App records
src/backend/stores/app/AppStore.js
Developer platform
- AI endpoints
src/backend/controllers/puterai/PuterAIController.ts - AI chat driver
src/backend/drivers/ai-chat/ChatCompletionDriver.ts - Serverless workers
src/backend/drivers/workers/WorkerDriver.ts - Key-value database
src/backend/drivers/kv/KVStoreDriver.ts
Backend foundations
- User accounts
src/backend/stores/user/UserStore.ts - Usage metering
src/backend/services/metering/MeteringService.ts - Database clients
src/backend/clients/database/DatabaseClient.ts - Object storage
src/backend/clients/s3/S3Client.ts
Other components
- User
- App developer
Connections 18
- User → Auth endpoints: signs in
README.md - Auth endpoints → Authentication: uses auth
src/backend/controllers/auth/AuthController.ts - Auth endpoints → User accounts: reads accounts
src/backend/controllers/auth/AuthController.ts - Authentication → User accounts: loads users
src/backend/services/auth/AuthService.ts - User → File API: manages files
README.md - File API → Filesystem service: performs operations
- File API → Path resolution: resolves paths
src/backend/controllers/fs/FSController.ts - File API → Shared path masking: masks paths
src/backend/controllers/fs/FSController.ts - File API → File metadata: reads and writes
- App developer → App management: publishes apps
README.md - App management → App records: manages records
- App developer → AI endpoints: requests AI
README.md - AI endpoints → AI chat driver: invokes chat
src/backend/controllers/puterai/PuterAIController.ts - App developer → Serverless workers: runs workers
README.md - App developer → Key-value database: uses key-value data
README.md - App developer → Object storage: uses cloud storage
README.md - AI endpoints → Usage metering: accounts usage
- Filesystem service → Database clients: persists metadata