How opengenesishq/eastgenesis works
EastGenesis is a local-first Electron AI assistant whose central workflow is task submission, automatic model selection, and a provider-backed response. The graph also preserves documented product branches for browser research, Office generation, development tools, MCP integration, and routing configuration. Source excerpts show session-engine creation, runtime routing/recovery, provider credential handling, and routing-preview validation; some cross-layer product links are documented in the README rather than demonstrated in sampled call sites.
Main entry points: openaiEngine.ts Model Turn Runtime · providers.ts Provider Profiles · session-engine-creation.ts Session Engine Setup · engines.ts Model Providers
Components 20
Conversation Runtime
- Session Engine Setup
src/main/session-engine-creation.ts - Model Turn Runtime
src/main/openaiEngine.ts - Conversation History
src/main/transcript.ts - Task Orchestration
src/main/agent/dag-scheduler.ts - Memory Management
src/main/memory/memory-manager.ts
Routing and Providers
- Routing Preview
src/main/routing-service/routing-preview-context.ts - Routing Policy Parser
src/shared/routing-policy-parser.ts - Provider Profiles
src/main/providers.ts - Provider Authorization
src/main/provider/providerAuthorizationService.ts - Billing Queries
src/main/provider/providerBillingQueryService.ts - Model Providers
src/main/engines.ts
Assistant Capabilities
- Browser and Search
src/main/browser/browser-manager.ts - Office Generation
src/main/agent/tools/office-creation-tools.ts - Development Tools
src/main/agent/tools/git-tools.ts - MCP Integration
src/main/mcp/mcp-oauth-service.ts
Desktop Interface
- Conversation UI
src/renderer/src/App.tsx - Desktop Bridge
src/preload/index.ts - Session Query IPC
src/main/ipc/session-query-handlers.ts - Routing Controls
src/renderer/src/components/composer/SessionRoutingFields.tsx
Other components
- User
Connections 19
- User → Conversation UI: submits task
README.md - Conversation UI → Desktop Bridge: uses desktop API
- Desktop Bridge → Session Query IPC: invokes session query
- Session Query IPC → Session Engine Setup: selects session runtime
- Session Engine Setup → Model Turn Runtime: creates engine
src/main/session-engine-creation.ts - Model Turn Runtime → Conversation History: replays history
src/main/openaiEngine.ts - Model Turn Runtime → Model Providers: routes model turn
src/main/openaiEngine.ts - Model Providers → Provider Profiles: uses provider profiles
- User → Routing Controls: sets routing intent
README.md - Routing Controls → Routing Policy Parser: parses policy
src/renderer/src/components/composer/SessionRoutingFields.tsx - Routing Preview → Routing Policy Parser: validates policy input
- Provider Profiles → Provider Authorization: authorizes provider
src/main/provider/providerAuthorizationService.ts - Provider Profiles → Billing Queries: queries billing
src/main/provider/providerBillingQueryService.ts - User → Browser and Search: browses and searches
README.md - User → Office Generation: requests documents
README.md - User → Development Tools: uses development tools
README.md - User → MCP Integration: connects MCP tools
README.md - Model Turn Runtime → Task Orchestration: coordinates tasks
- Model Turn Runtime → Memory Management: uses task memory