Security advisory — Malicious litellm versions 1.82.7 and 1.82.8 were removed from PyPI (potential API key exfiltration). Uninstall them, rotate exposed credentials, and upgrade to a safe release (e.g. 1.82.9+). Run pip show litellm to verify. PyPI · README

FAQ

Frequently asked questions about AgenticX.

FAQ

Pick a form first, then a page. Most “it disappeared” bugs are a wrong process (agx studio vs agx serve) or a wrong session file.

Diagram: pick SDK, Near, or Enterprise — they are different processes.

General

What is AgenticX?

AgenticX is one capability core with three forms: Python SDK + Agent Runtime, Near Desktop as a local-first workspace, and Enterprise for access, governance, and audit. Studio is the local REST API + SSE backend. It does not ship a built-in web chat UI.

How do the three forms differ?

  • SDK: Agent + Task + AgentExecutor.run(agent=, task=) in your process
  • Near: Electron UI over local agx serve
  • Enterprise: Portal / Admin / Go Gateway — policy and model relay, not the Python think-act loop

Is AgenticX open source?

Yes. AgenticX is licensed under Apache-2.0. See the repository LICENSE file.

Installation

What Python version is required?

Python 3.10 or higher.

How do I install optional features?

bash
1pip install "agenticx[all]"    # Everything
2pip install "agenticx[vector]" # Vector store support
3pip install "agenticx[doc]"    # Document parsing

LLM Providers

Which LLM providers are supported?

15+ providers including OpenAI, Anthropic, Ollama (local), Gemini, Kimi/Moonshot, MiniMax, Ark/VolcEngine, Zhipu, Qianfan, and Bailian/Dashscope.

Can I use local models?

Yes. Use the OllamaProvider to connect to locally running models via Ollama:

python
1from agenticx.llms import OllamaProvider
2llm = OllamaProvider(model="llama3.2", base_url="http://localhost:11434")

Does MiniMax support image inputs?

No. All minimax-m2* models do not support image or audio inputs. The framework will warn you if you try to send images to these models.

Tools & MCP

What is MCP?

Model Context Protocol is an open standard for connecting AI agents to tools and data sources. AgenticX includes an MCP Hub that can connect to multiple MCP servers simultaneously.

Can I use tools from other frameworks?

Yes. AgenticX can import tools from LangChain, use OpenAPI specs to auto-generate toolsets, or call any HTTP endpoint via Remote Tools.

Memory

Where is memory stored?

By default, memory is stored in SQLite at ~/.agenticx/workspace/. You can configure Redis or PostgreSQL for production deployments.

Does memory persist across restarts?

Yes. All memory backends (SQLite, Redis, PostgreSQL) persist data between sessions.

Studio & Desktop

How do I start the local backend?

bash
1agx serve --host 127.0.0.1 --port 8000

agx serve is a REST API + SSE backend. It does not ship a built-in web chat UI. Use Near Desktop as the local workspace, or talk to Studio from the Python SDK / agx CLI.

What is Near Desktop?

Near is the local-first Electron workspace. The default path starts a local agx serve / agx-server, then keeps multi-pane chat, avatars, group chat, workspace, terminal, and session restore on that backend.

Contributing

How can I contribute?

See CONTRIBUTING.md on GitHub.

How do I report a bug?

Open an issue on GitHub Issues.