Skip to main content

A framework for building distributed evolvable multi-agent system.

Project description


1 What is PantheonOS?

PantheonOS is an evolvable, privacy-preserving multi-agent framework designed to reconcile generality with domain specificity. Autonomous agents powered by large language models collaborate to conduct biological discovery — achieving super-human performance on specialized scientific tasks.

Key Highlights

  • Distributed Architecture — NATS-based messaging for scalable, fault-tolerant deployments across machines
  • Evolvable — Pantheon-Evolve module enables agents to improve algorithms and code through genetic-algorithm-driven agentic code evolution
  • Multi-Agent Teams — PantheonTeam, Sequential, Swarm, Mixture-of-Agents (MoA), and AgentAsTool team patterns for flexible orchestration
  • Friendly Interfaces — Interactive CLI (pantheon cli) and Chatroom UI (pantheon ui)

2 Quick Start & Community

pip install pantheon-agents
Join our Slack community!
Join our Discord community!

3 Installation

Using uv (Recommended)

uv is a fast Python package manager that handles dependencies efficiently.

# Install uv (if not already installed)
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone and install
git clone https://github.com/aristoteleo/PantheonOS.git
cd PantheonOS
uv sync

# With optional dependencies
uv sync --extra knowledge  # RAG/vector search support
uv sync --extra slack      # Slack integration
uv sync --extra r          # R language support (requires R installed)

Using pip

# Basic installation
pip install pantheon-agents

# With optional dependencies
pip install "pantheon-agents[knowledge]"  # RAG/vector search support
pip install "pantheon-agents[slack]"      # Slack integration

Development Installation

git clone https://github.com/aristoteleo/PantheonOS.git
cd PantheonOS
uv sync --extra dev --extra knowledge

# Run tests
uv run pytest tests/

4 Usage

CLI Mode

# Start the interactive REPL
pantheon cli

Chatroom UI

# Start the multi-agent chatroom
pantheon ui --auto-start-nats --auto-ui

API Usage

Please refer to our Documents for detailed API usage, including creating agents, using toolsets, and building teams.

5 Contributing

Contributions of all types are more than welcome! If you are interested in contributing code, feel free to check out our GitHub Issues to dive in.

License

This project is BSD 2-Clause licensed.

Copyright © 2026 Qiu Lab.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pantheon_agents-0.4.5-py3-none-any.whl (1.2 MB view details)

Uploaded Python 3

File details

Details for the file pantheon_agents-0.4.5-py3-none-any.whl.

File metadata

File hashes

Hashes for pantheon_agents-0.4.5-py3-none-any.whl
Algorithm Hash digest
SHA256 b221590e77d2a1223799d53006e20a74a46737134f4382afc86445a76cef744f
MD5 19bb246aff3e3c26cf3a5e81d28a3205
BLAKE2b-256 f7abbd2d375325466d7ac784e6bf301d9a1f63e31f385bf90eefb6453cbdbe49

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page