Skip to main content

Mana-Agent

Mana-Agent

Think beyond prompts. Build beyond boundaries.

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

Python License GitHub

English · العربية · বাংলা · Brezhoneg · Bosanski · Dansk · Deutsch · Español · فارسی · Français · Ελληνικά · Italiano · 日本語 · 한국어 · Norsk · Polski · Русский · ไทย · Türkçe · Українська · Tiếng Việt · 简体中文 · 繁體中文

Get Started · Capabilities


Live steering status: Steering an ongoing execution, including Ctrl+S, is not available yet. Plan Mode remains separate and its approval requirements continue to apply. See the steering design for the safety work and integration still required.

OpenAI Batch is used only when explicitly requested. Other batching uses Mana's internal parallel execution. Required Batch tasks pause durably and resume with results; conversation follow-ups retain both user and assistant context across frontends. See Batch execution and recovery.

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?

Your challenge What Mana-Agent can help with
"I don't understand this codebase." Explore architecture, dependencies, execution flows, and relevant files.
"Something is broken." Investigate symptoms, identify likely causes, propose fixes, and run verification.
"I want to build something complex." Decompose goals, coordinate coding agents, manage dependencies, and review implementation.
"This task has too many steps." Track progress through the autonomous loop, TaskBoard, and execution supervisor.
"I need information from an API." Inspect API documentation, validate requests, and execute supported operations.
"I keep repeating this workflow." Create automations or teach repeatable actions using Teach Mode.
"I want AI to work across tools." Integrate browser, Git, SSH, email, Telegram, protocols, and external services.
"What happened during execution?" Inspect activity, tools, decisions, errors, checkpoints, and artifacts.

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.

Metadata

Release files for mana-agent 0.8.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mana-agent 0.8.0
File Size Uploaded Provenance Actions
mana_agent-0.8.0.tar.gz 2.5 MB With provenance Details for mana_agent-0.8.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mana-agent 0.8.0
File Interpreter ABI Platform Actions
mana_agent-0.8.0-py3-none-any.whl Python 3 none any Details for mana_agent-0.8.0-py3-none-any.whl

Total release size: 5.0 MB

Release files / mana_agent-0.8.0.tar.gz

Download URL mana_agent-0.8.0.tar.gz
Size 2.5 MB
Tags Source
SHA-256 checksum
How to use checksums
e268bcf1dc8fdabc41a3307b82d0888f3bd80b1bdb7935c433327cc6266b5ea5
BLAKE2b-256 checksum
How to use checksums
4979974098a81bffb8353ed64f0b1e984672c5e0fa73014e5fafd59ea84ad5e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / mana_agent-0.8.0-py3-none-any.whl

Download URL mana_agent-0.8.0-py3-none-any.whl
Size 2.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
2f3997c0cce1d79ad24e4f2f7c88c748818bea096085e27ec207769267ee0fec
BLAKE2b-256 checksum
How to use checksums
7b7a986f938b022de377f112947ea11434459461d9e6196d615cee371d12e974
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for mana-agent 0.8.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for mana_agent-0.8.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.8.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page