How medhiclb/helixai works
Helix AI is a local-first desktop AI workspace for individuals and organisations. The principal workflow is to bring a question and optional documents to Chat, use a selected local or explicitly configured cloud model—optionally with knowledge-base context—and receive a sourced answer. The product also supports coding, persistent agents and scheduled tasks, model fine-tuning, team administration, and user-connected services. The graph combines README-documented capabilities with paths and relationships visible in the supplied source index and excerpts; unsampled implementation details are not inferred.
Main entry points: index.ts Gateway API · App.tsx Application routing · chat.ts Chat service · atelier.ts Agent runtime
Components 27
Desktop experience
- Application routing
src/App.tsx - Chat experience
src/components/chat - Coding workspace
src/pages/CodePage.tsx - Agents workspace
src/pages/AgentsPage.tsx - Knowledge library
src/pages/BibliothequePage.tsx - Task board
src/pages/TachesPage.tsx - Product configuration
src/config/branding.ts
AI and knowledge
- Chat service
gateway/src/chat.ts - Model backends
gateway/src/backends.ts - Local engine setup
gateway/src/engine.ts - Knowledge bases
gateway/src/bibliotheque.ts - Model fine-tuning
gateway/src/entrainement.ts
Work automation
- Code execution
- Agent runtime
gateway/src/atelier.ts - Scheduled missions
gateway/src/tachesProgrammees.ts
Services and teams
- Connected services
gateway/src/connecteurs.ts - Accounts and groups
gateway/src/accounts.ts - Access and audit
gateway/src/authz.ts - Protected zones
gateway/src/zonesProtegees.ts
Runtime and state
- Gateway API
gateway/src/index.ts - Instance database
gateway/src/db.ts - Client identity
src/lib/store/identity.ts - Client persistence
src/lib/store/storage.ts - Instance sync
src/lib/store/sync.ts - Electron host
electron/main.cjs - Gateway language
gateway/src/langue.ts
Other components
- Person
Connections 34
- Person → Application routing: uses
README.md - Application routing → Chat experience: routes to
src/App.tsx - Application routing → Coding workspace: routes to
src/App.tsx - Application routing → Agents workspace: routes to
src/App.tsx - Application routing → Knowledge library: routes to
src/App.tsx - Application routing → Task board: routes to
src/App.tsx - Chat experience → Chat service: sends requests
- Chat service → Model backends: selects model
README.md - Chat service → Knowledge bases: uses context
README.md - Person → Knowledge bases: adds documents
README.md - Person → Model fine-tuning: trains model
README.md - Person → Coding workspace: works in
README.md - Person → Agent runtime: configures agents
README.md - Agents workspace → Agent runtime: manages agents
- Task board → Scheduled missions: manages tasks
README.md - Agent runtime → Scheduled missions: runs missions
README.md - Person → Connected services: connects services
README.md - Person → Accounts and groups: uses team features
README.md - Accounts and groups → Access and audit: uses access controls
README.md - Gateway API → Chat service: routes requests
gateway/src/index.ts - Gateway API → Knowledge bases: routes requests
gateway/src/index.ts - Gateway API → Model fine-tuning: routes requests
gateway/src/index.ts - Gateway API → Connected services: routes requests
gateway/src/index.ts - Gateway API → Accounts and groups: routes requests
gateway/src/index.ts - Gateway API → Access and audit: routes requests
gateway/src/index.ts - Model backends → Local engine setup: may use local engine
- Client identity → Client persistence: reads and writes
src/lib/store/identity.ts - Client persistence → Instance sync: pushes changes
src/lib/store/storage.ts - Instance sync → Gateway API: synchronizes with
src/lib/store/sync.ts - Gateway API → Instance database: persists data
gateway/src/index.ts - Electron host → Application routing: hosts interface
- Product configuration → Application routing: configures features
src/App.tsx - Gateway API → Gateway language: uses language context
gateway/src/index.ts - Gateway API → Protected zones: uses protected zones
gateway/src/index.ts