How theory903/open-ippoc works
IPPOC-OS is a sovereign cognitive operating system: an operator submits signals or controls autonomy, Cortex processes cognitive work and invokes tools, and Soma supplies identity, trust, and memory services. Its documented capabilities also include persistent memory, intent/reflection loops, auditable execution, and optional OpenClaw integration. The source excerpts support the cognitive-to-tool path; README statements support the service and CLI capabilities. Several subsystems are represented from documentation and the tree, so their internal links are omitted where source wiring was not shown.
Main entry points: server.py Cortex API · orchestrator.py Tool Orchestrator · langgraph_engine.py Cognitive Workflow · main.rs Soma Identity and Trust
Components 18
Runtime and API
- IPPOC CLI
src/ippoc/cli/main.py - Service Startup
src/ippoc/runtime/bootstrap/genesis.ts - Cortex API
src/ippoc/cortex/cortex/server.py - OpenClaw Adapter
src/ippoc/cortex/plugins/openclaw/openclaw_adapter.py
Cognition and Autonomy
- Cognitive Schemas
src/ippoc/cortex/cortex/schemas.py - Cognitive Workflow
src/ippoc/cortex/cortex/langgraph_engine.py - Two-Tower Reasoning
src/ippoc/cortex/cortex/two_tower.py - Telepathy Swarm
src/ippoc/cortex/cortex/telepathy.py - Intent Engine
src/ippoc/maksad/intent_engine.py - Reflection Engine
src/ippoc/maksad/reflection_engine.py - Autonomy Controls
src/ippoc/cortex/core/autonomy.py
Policy and Execution
- Tool Orchestrator
src/ippoc/cortex/core/orchestrator.py - Tool Contract
src/ippoc/cortex/core/tools/base.py - Capability Tools
src/ippoc/cortex/core/tools - Action Ledger
src/ippoc/cortex/core/ledger.py
Identity and Memory
- Soma Identity and Trust
src/ippoc/soma/src/main.rs - Memory Services
src/ippoc/mnemosyne
Other components
- Operator
Connections 22
- Operator → IPPOC CLI: controls
README.md - Operator → Cortex API: submits signals
README.md - IPPOC CLI → Service Startup: starts services
- Service Startup → Soma Identity and Trust: starts first
README.md - Service Startup → Cortex API: starts next
README.md - Cortex API → Cognitive Schemas: uses schemas
- Cortex API → Cognitive Workflow: dispatches cognition
- Cognitive Workflow → Two-Tower Reasoning: requests impulse
src/ippoc/cortex/cortex/langgraph_engine.py - Cognitive Workflow → Telepathy Swarm: uses swarm
src/ippoc/cortex/cortex/langgraph_engine.py - Cognitive Workflow → Tool Orchestrator: invokes tools
src/ippoc/cortex/cortex/langgraph_engine.py - Tool Orchestrator → Tool Contract: executes contract
- Tool Orchestrator → Capability Tools: dispatches
src/ippoc/cortex/core/orchestrator.py - Tool Orchestrator → Action Ledger: audits actions
- Tool Orchestrator → Soma Identity and Trust: authenticates with
- Cortex API → Soma Identity and Trust: validates keys
- Cortex API → Memory Services: uses persistent memory
- Reflection Engine → Soma Identity and Trust: reads recent memory
src/ippoc/maksad/reflection_engine.py - Reflection Engine → Intent Engine: creates intents
src/ippoc/maksad/reflection_engine.py - Intent Engine → Cognitive Schemas: emits thoughts
src/ippoc/maksad/intent_engine.py - Operator → Autonomy Controls: sets autonomy
README.md - Cortex API → Autonomy Controls: exposes controls
- Operator → OpenClaw Adapter: integrates optionally
README.md