Skip to content

aristoteleo/PantheonOS

Repository files navigation


PantheonOS is an evolvable and privacy-preserving multi-agent framework designed to reconcile generality with domain specificity. PantheonOS automates, scales and accelerates data sciences, with a particular focus on end-to-end single cell biology analyses. Cruicially, PantheonOS leverages agentic code evolution to optimize state-of-the-art and nascent algorithms, achieving super-human performance on specialized scientific tasks.

Key Highlights

  • 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
  • Distributed Architecture — NATS-based messaging for scalable, fault-tolerant deployments across machines
  • Friendly Interfaces — Interactive CLI (pantheon cli) and Chatroom UI (pantheon ui)
  • Pantheon Store — A community marketplace with 1,000+ curated agents, teams, and skills for biomedical AI, installable via UI or CLI
Play with our Web UI!
Browse 1,000+ agents, teams, and skills!
pip install pantheon-agents
Join our Slack community!
Join our Discord community!

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/

Using Docker

Docker Pulls

Run Pantheon in a containerized environment with everything pre-configured:

# Pull the image
docker pull nanguage/pantheon-agents:latest

# Run in standalone mode (for local use)
docker run -it --rm \
  -e PANTHEON_MODE=standalone \
  -v $(pwd)/workspace:/workspace \
  -p 8080:8080 \
  nanguage/pantheon-agents:latest

After startup, copy the displayed connection URL to your browser and start using Pantheon!

For detailed Docker usage, deployment modes, and configuration options, see the Docker documentation.

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.

Contributions of all types are more than welcome! Whether it's publishing skills to the Pantheon Store or 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.

Packages

 
 
 

Contributors

Languages