How sweetcornna/corlinman works
Corlinman is a self-hosted intelligent-agent platform. A user sends a request through a chat channel, the admin chat, or the HTTP/SSE interface; the shared agent loop reasons with configured models and tools, then returns a response through the initiating interface. Separate capabilities provide session history, searchable knowledge, approvals, channel integrations, and scheduled evolution. The README documents these major product branches; sampled source confirms selected embedding, scheduler, and MCP-client behavior, but not every gateway or UI connection.
Main entry points: reasoning_loop.py Reasoning Loop · ui Admin Console · corlinman_server Gateway · corlinman_providers Model Providers
Components 19
User Interfaces
- Chat Channels
python/packages/corlinman-channels/src/corlinman_channels - Admin Console
ui - Gateway
python/packages/corlinman-server/src/corlinman_server
Agent Runtime
- Reasoning Loop
python/packages/corlinman-agent/src/corlinman_agent/reasoning_loop.py - Agent Definitions
python/packages/corlinman-agent/src/corlinman_agent/agents - Model Providers
python/packages/corlinman-providers/src/corlinman_providers
Memory and Retrieval
- Embedding Router
python/packages/corlinman-providers/src/corlinman_providers/embedding_router.py - Session History
python/packages/corlinman-agent/src/corlinman_agent/session.py - Knowledge Retrieval
python/packages/corlinman-memory-host/src/corlinman_memory_host
Tools and Governance
- Plugin Runtime
python/packages/corlinman-mcp-server/src/corlinman_mcp_server - MCP Clients
python/packages/corlinman-mcp-server/src/corlinman_mcp_server/client_manager.py - Approval Gate
python/packages/corlinman-agent/src/corlinman_agent/approval_gate.py
Operations
- Scheduler
python/packages/corlinman-server/src/corlinman_server/scheduler/builtins/evolution_engine_run_once.py - Evolution Engine
python/packages/corlinman-evolution-engine/src/corlinman_evolution_engine/engine.py - Evolution Store
python/packages/corlinman-evolution-engine/src/corlinman_evolution_engine/store.py
Other components
- User
- Model APIs
- External MCP Servers
- Operator
Connections 19
- User → Chat Channels: sends message
- Chat Channels → Gateway: routes request
- User → Admin Console: uses console
- Admin Console → Gateway: HTTP/SSE
- Gateway → Reasoning Loop: dispatches turn
- Agent Definitions → Reasoning Loop: configures agent
- Reasoning Loop → Model Providers: requests completion
- Model Providers → Model APIs: calls model
- Reasoning Loop → Session History: reads/writes history
- Reasoning Loop → Knowledge Retrieval: retrieves knowledge
- Reasoning Loop → Embedding Router: requests embeddings
- Embedding Router → Model Providers: forwards embedding
- Reasoning Loop → MCP Clients: discovers and invokes tools
- MCP Clients → External MCP Servers: connects to servers
- Reasoning Loop → Approval Gate: checks tool permission
- Operator → Admin Console: governs platform
- Scheduler → Evolution Engine: runs pass
- Evolution Engine → Evolution Store: persists proposals
- Operator → Evolution Store: reviews proposals