An open foundation, with applications for work and personal life.
![]() |
The open-source agent runtime and core infrastructure. Reusable foundations for execution, model integration, tools, conversations, and extensions. Source code · Quick start · Architecture |
![]() |
A desktop AI agent for practical work and multi-step tasks, built on FluxOS. The workspace, native adapters, and product services are developed separately from the open-source core. Desktop product · Private source |
![]() |
A personal AI agent in development, focused on long-term personal context, memory, and ongoing collaboration. Personal AI · Early-stage development |
FluxOS focuses on making agent execution controllable, traceable, and recoverable.
| Foundation | What it means | |
|---|---|---|
| 🛡️ | Controlled tool use | Tool contracts, access checks, and approval policies define how actions run. |
| 🧾 | Traceable execution | Tool results, process exits, and task acceptance are represented separately. |
| 🕘 | Recoverable state | Persisted events, execution receipts, and checkpoints retain task history. |
| 🧩 | Room to extend | MCP, Skills, plugins, and connectors provide integration points. |
TypeScript · Node.js · Electron · npm workspaces · GitHub Actions
The FluxOS core has 10 independently built packages, with CI on Linux, macOS, and Windows. Electron belongs to the desktop product; browser, computer, and terminal adapters are supplied by applications.
📦 Explore the 10 core packages
| Layer | Packages |
|---|---|
| Shared foundations | contracts · platform |
| Models, tools & integrations | models · tools · extensions |
| Agent execution | agent-runtime |
| State & lifecycle | conversations · profiles · automations |
| Presentation | presentation |
Package ownership and dependencies are documented in the FluxOS architecture.
- ⚡ Source & quick start — Explore FluxOS and build the core locally.
- 📖 Architecture — Understand the packages and their boundaries.
- 💬 Issues — Report reproducible bugs or discuss integrations.
- 🤝 Contribution guidelines — Read the contribution scope and process.



