How icanzzzz/chatbox works
Chatbox is a cross-platform AI chat client whose primary workflow is configuring a provider, composing a prompt, streaming a model response, and retaining the conversation locally. The repository separates renderer UI, shared application/domain services, and Electron main-process capabilities. README-documented features also include image generation, prompt reuse, and knowledge-base workflows. Several implementation paths were not sampled, so uncertain UI-to-service and IPC connections are omitted or marked unverified rather than inferred.
Main entry points: GenerationService.ts Generation service · main.ts Electron main · KnowledgeBase.tsx Knowledge-base UI · InputBox.tsx Prompt composer
Components 23
Chat experience
- Chat UI
src/renderer/components/chat/MessageList.tsx - Prompt composer
src/renderer/components/InputBox/InputBox.tsx - Provider settings
src/renderer/components/settings/provider/ProviderList.tsx - Model selection
src/renderer/components/ModelSelector/index.tsx
Chatbox core
- Session service
packages/chatbox-core/src/application/session/SessionService.ts - Session repository port
packages/chatbox-core/src/ports/session-repository.ts - Session metadata storage
src/renderer/storage/SessionMetaStorage.ts - Generation service
packages/chatbox-core/src/generation/GenerationService.ts - Model factory
packages/chatbox-core/src/application/model/ModelFactory.ts - Provider models
src/shared/providers/definitions/models/volcengine.ts - Settings service
packages/chatbox-core/src/application/settings/SettingsService.ts - Settings storage port
packages/chatbox-core/src/ports/settings-storage.ts
Desktop runtime
- Electron main
src/main/main.ts - Preload bridge
src/preload/index.ts - Local file parsing
src/main/file-parser.ts
Knowledge and tools
- Knowledge-base UI
src/renderer/components/knowledge-base/KnowledgeBase.tsx - Knowledge IPC handlers
src/main/knowledge-base/ipc-handlers.ts - Knowledge database
src/main/knowledge-base/db.ts - Session attachment RAG
src/main/session-attachment-rag/ipc-handlers.ts - Sandbox execution
src/main/sandbox/manager.ts - Skills
src/main/skills/ipc-handlers.ts
Other components
- User
- LLM provider
Connections 19
- User → Provider settings: configures provider
README.md - User → Prompt composer: submits prompt
README.md - User → Chat UI: reads response
README.md - Provider settings → Settings service: saves settings
- Model selection → Model factory: selects model
- Prompt composer → Generation service: starts generation
- Generation service → Provider models: dispatches request
- Provider models → LLM provider: calls model API
src/shared/providers/definitions/models/volcengine.ts - Generation service → Chat UI: streams reply
README.md - Session service → Session repository port: reads and writes
packages/chatbox-core/src/application/session/SessionService.ts - Session repository port → Session metadata storage: stores metadata
- Settings service → Settings storage port: persists settings
- Electron main → Local file parsing: parses files
src/main/main.ts - Electron main → Preload bridge: exposes bridge
- Knowledge-base UI → Knowledge IPC handlers: requests operations
- Knowledge IPC handlers → Knowledge database: uses database
src/main/knowledge-base/ipc-handlers.ts - Knowledge-base UI → Session attachment RAG: indexes attachments
- User → Sandbox execution: runs tool tasks
- User → Skills: uses skills