How arafa1974/librechat works
LibreChat is a self-hosted, full-stack AI chat application. A user works through the browser UI to converse with configured model endpoints; the product also supports Agents, tools and MCP, files, schedules, authentication, and observability. The tree and README establish these major capabilities, while sampled source confirms selected internal relationships: trigger dispatch, stream job management, and the data-provider query layer. Many domain routes and integrations were not sampled, so their links are marked unverified rather than presented as inspected call paths.
Main entry points: index.js HTTP API · StreamRunManager.js Run manager · request.js Agent API · engine.ts Trigger engine
Components 24
Chat experience
- Web application
client/src/App.jsx - Chat interface
client/src/components/Chat/ChatView.tsx - Data query hooks
packages/data-provider/src/react-query/react-query-service.ts - API data service
packages/data-provider/src/data-service.ts
Conversation runtime
- Chat endpoints
api/server/routes/convos.js - Run manager
api/server/services/Runs/StreamRunManager.js - Generation jobs
packages/api/src/stream/GenerationJobManager.ts - Job store
packages/api/src/stream/implementations/InMemoryJobStore.ts - Model clients
api/app/clients/BaseClient.js
Agents and tools
- Agent API
api/server/controllers/agents/request.js - Trigger engine
packages/api/src/agents/triggers/engine.ts - Trigger dispatch
packages/api/src/agents/triggers/dispatch.ts - Tools and MCP
api/server/services/ToolService.js - Schedules
packages/api/src/schedules/engine.ts
Platform services
- HTTP API
api/server/routes/index.js - File services
api/server/services/Files/operations.js - File storage
packages/api/src/files/storage.ts - Application database
api/db/connect.js - Authentication
api/server/services/AuthService.js
External integrations
- Channel gateway
packages/channel-gateway/src/app.ts - Model providers
- MCP servers
- Slack
Other components
- User
Connections 24
- User → Web application: uses
README.md - Web application → Chat interface: renders
- Chat interface → Data query hooks: requests data
- Data query hooks → API data service: calls
packages/data-provider/src/react-query/react-query-service.ts - API data service → HTTP API: HTTP requests
- HTTP API → Chat endpoints: routes
- Chat endpoints → Run manager: starts runs
- Run manager → Generation jobs: manages jobs
- Generation jobs → Job store: persists jobs
packages/api/src/stream/GenerationJobManager.ts - Run manager → Model clients: invokes
- Model clients → Model providers: calls
README.md - HTTP API → Authentication: authenticates
- HTTP API → Application database: uses
- HTTP API → File services: serves file operations
- File services → File storage: delegates storage
- File storage → Application database: coordinates metadata
- HTTP API → Agent API: routes agent requests
- Agent API → Trigger engine: queues triggers
- Trigger engine → Trigger dispatch: dispatches
packages/api/src/agents/triggers/engine.ts - Trigger dispatch → Agent API: invokes handlers
- HTTP API → Tools and MCP: serves tool requests
- Tools and MCP → MCP servers: connects tools
README.md - Schedules → Trigger engine: fires agent triggers
packages/api/src/schedules/engine.ts - Channel gateway → Slack: handles channel events
README.md