DemonDamon / AgenticX

**A unified agent technology stack spanning the Python Agent Runtime, Near Desktop, and Enterprise**
Product Architecture • Core Capabilities • Quick Start • Examples • Progress
---
**Language / 语言**: English | 中文
---
## Security advisory
**LiteLLM (PyPI):** Malicious releases **`litellm` 1.82.7 and 1.82.8** were removed from PyPI after reports that they could **exfiltrate API keys**. If you ever installed either version, **uninstall** them, **rotate any credentials** that may have been exposed, and **upgrade** to a release the upstream project and PyPI list as safe (for example **1.82.9+**, per current upstream guidance). Check your environment with `pip show litellm`.
---
## Vision
**AgenticX** provides a unified, scalable, production-ready agent technology stack. Developers can build directly with the Python SDK and `agx` CLI, use **Near Desktop** as a local-first multi-agent workspace, or deploy **AgenticX Enterprise** for enterprise access, governance, compliance gateway, and audit capabilities.
## System Architecture
The architecture consists of one shared capability core and two product forms:
- **AgenticX Core / Runtime**: Python SDK, Studio Server, and Agent Runtime for orchestration, tools, MCP, memory, knowledge bases, Skills, Hooks, model adapters, secure sandboxes, observability, and evaluation.
- **Near Desktop**: An Electron + React local-first workspace. Its default path connects to a local `agx serve / agx-server`, with multi-pane chat, avatars and group chat, workspaces, terminal, automation, Voice Focus, and an optional remote single-server backend.
- **AgenticX Enterprise**: Web Portal, Admin Console, and Go AI Gateway for enterprise use. Employee chat passes through Portal BFF before the Gateway. The Gateway handles authentication, policy, quota, model relay, response governance, audit, and usage; it is **not a full Agent Runtime**.
Near and Enterprise share AgenticX abstractions and capabilities, but their current deployment paths are independent. Near defaults to the local Python Runtime; Enterprise uses the Go Gateway for its current online path. Enterprise Edge Agent is an MVP outside the default path, while Cluster Agent Runtime remains planned.
## Core Features
### Core Framework
- **Agent Core**: Agent execution engine based on 12-Factor Agents methodology, with Meta-Agent CEO dispatcher, agent team management, think-act loop, event-driven architecture, self-repair, and overflow recovery
- **Embeddable ReActAgent (SDK primitive)**: Canonical async function-calling ReAct loop (`ainvoke`/`astream`) with a typed `AgentEvent` stream, multi-turn history in/out, parallel tool execution, and optional loop-detector / compactor / offloader injection — zero Studio/CLI coupling (legacy text-JSON `TextReActAgent` facade kept for compatibility)
- **Unified Offload**: `Offloader` protocol + filesystem-backed `FileOffloader` keep large tool results / compressed context out of live history (inline reference placeholders, retrieved on