How sitionix/forge-ai works
Forge AI is a local platform whose operator-facing workflow centers on managing projects and workflows, then executing agent workflows and observing their runs. Forge Agent owns workflow execution; Nexus provides typed platform-facing proxies, while the Console is the operator UI. Knowledge retrieval and Jarvis form a separate assistant capability. Remote access and MCP are additional Agent capabilities. The tree and excerpts support these subsystem boundaries, but not every internal call path; uncertain wiring is omitted.
Main entry points: api Agent API · usecase Agent use cases · NodeRunWorker.java Node execution · knowledge_query_service.py Knowledge retrieval
Components 18
Operator experience
- Forge Console
services/forge-console
Platform proxy
- Forge Nexus
services/forge-nexus - Agent proxy
services/forge-nexus/application/src/main/java/com/sitionix/forgeai/application/agentproxy
Agent workflows
- Agent API
services/forge-agent/api-rest/src/main/java/com/sitionix/forgeagent/api - Agent use cases
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/usecase - Workflow validation
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/graph - Workflow coordinator
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/runtime/WorkflowExecutionCoordinator.java - Node execution
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/runtime/NodeRunWorker.java - Session leases
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/runtime/AgentSessionLeaseService.java - Execution events
services/forge-agent/api-rest/src/main/java/com/sitionix/forgeagent/api/AgentExecutionEventsController.java
Agent integrations
- Remote access
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/remoteaccess - MCP gateway
services/forge-agent/application/src/main/java/com/sitionix/forgeagent/application/mcp/McpGatewayService.java
Knowledge assistant
- Knowledge retrieval
services/forge-knowledge/src/knowledge_service/knowledge_query_service.py - Flow exploration
services/forge-knowledge/src/knowledge_service/local_flow_unit_engine.py - Knowledge storage
services/forge-knowledge/src/knowledge_service/storage_operations.py - Jarvis assistant
services/forge-jarvis/src/jarvis_agent/query_service.py - Knowledge gateway
services/forge-jarvis/src/jarvis_agent/query_service.py
Other components
- Operator
Connections 16
- Operator → Forge Console: uses
- Forge Console → Forge Nexus: requests
- Forge Nexus → Agent proxy: routes
- Agent proxy → Agent API: forwards typed requests
- Agent API → Agent use cases: handles requests
- Agent use cases → Workflow validation: validates workflow
- Agent use cases → Workflow coordinator: coordinates execution
- Workflow coordinator → Node execution: dispatches node runs
- Node execution → Session leases: claims sessions
- Agent API → Execution events: exposes events
- Agent API → Remote access: serves remote access
- Node execution → MCP gateway: accesses tools
- Jarvis assistant → Knowledge gateway: queries
- Knowledge gateway → Knowledge retrieval: sends query
- Knowledge retrieval → Flow exploration: assembles flows
- Knowledge retrieval → Knowledge storage: maintains storage