Mana-Agent

Think beyond prompts. Build beyond boundaries.

Your AI-powered execution workspace.
One goal. Multiple agents. Real tools. Verified results.

Get Started · Capabilities

What if your AI could do more than answer?

Most AI tools stop at the answer.

You ask a question. They generate a response. Then you're left to figure out what to do next.

Mana-Agent is built for what happens after the answer.

It can understand your goals, explore your environment, plan actions, coordinate specialized agents, use real tools, and verify outcomes.

Not just for writing code.

For researching, building, debugging, managing, automating, and solving complex tasks across connected systems.

You define the destination. Mana-Agent helps navigate the journey.

Meet Mana-Agent

Mana-Agent is an open-source, Python-based AI agent orchestration platform combining an autonomous execution loop, specialized agents, persistent task management, supervised tool execution, and extensible integrations.

It brings multiple capabilities into one coordinated environment:

• Understand: Analyze repositories, documents, APIs, and available evidence before taking action.
• Decide: Select suitable models, agents, tools, and execution strategies.
• Execute: Use coding tools, browser automation, external services, and connected systems.
• Coordinate: Distribute work among specialized agents while tracking dependencies and progress.
• Remember: Reuse authorized context, decisions, and lessons across relevant tasks.
• Verify: Evaluate actual outcomes rather than treating tool completion as success.
• Continue: Replan, recover, or request human intervention when the goal remains unresolved.

The objective is simple:

Make AI useful not only for thinking about work, but for carrying work through to a trustworthy result.

What can Mana-Agent do?

One interface. Many kinds of work.

> Explain how authentication works in this repository.

> Find why the latest deployment failed.

> Plan and implement a new feature, then run its tests.

> Read this API documentation and help me call the right endpoint.

> Analyze these files and produce an actionable report.

> Break this project into independent tasks and track progress.

> Review previous mistakes before attempting this operation again.

Mana-Agent is designed to support both focused questions and multi-step workflows.

Quick Start

1. Install

Requires Python 3.10–3.14.

Recommended installation with pipx:

pipx install git+https://github.com/manaplatform/mana-agent.git

Or install directly from the repository:

git clone https://github.com/manaplatform/mana-agent.git
cd mana-agent

python3 -m venv .venv
source .venv/bin/activate

python -m pip install -e .

2. Configure

mana-agent --configure

Configure your model provider, credentials, model preferences, and supported capabilities.

3. Start

cd /path/to/your/project
mana-agent

You're ready.

Start with a question about your repository, ask for an investigation, or describe something you want to accomplish.

Your first task doesn't need to be complicated.

Try:

Analyze this project and explain its architecture,
main components, dependencies, and potential risks.

4. Explore the dashboard

mana-agent dashboard --root-dir .

The optional dashboard provides another way to interact with Mana-Agent, inspect activity, and manage workflows.

License

Mana-Agent is open source under the MIT License.

Mana-Agent
From intention to execution. From execution to evidence.

Get Started · GitHub · Report an Issue · Explore the Docs

Have a goal in mind? Start with Mana.