Metadata-Version: 2.4
Name: pantheon-agents
Version: 0.5.3
Summary: A framework for building distributed evolvable multi-agent system.
Author: Weize Xu, Quan Zhong, Zehua Zeng, Xuehai Wang
License: MIT
Project-URL: Homepage, https://github.com/aristoteleo/pantheon-agents
Project-URL: Repository, https://github.com/aristoteleo/pantheon-agents
Project-URL: Issues, https://github.com/aristoteleo/pantheon-agents/issues
Keywords: multi-agent,llm,ai,distributed,mcp,autonomous-agents
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tomli>=2.0.1; python_version < "3.11"
Requires-Dist: diff-match-patch>=20241021
Requires-Dist: executor-engine>=0.3.3
Requires-Dist: fire>=0.7.0
Requires-Dist: funcdesc>=0.1.8
Requires-Dist: anthropic>=0.40.0
Requires-Dist: google-genai>=1.0.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: openai>=2.0.0
Requires-Dist: tiktoken>=0.7.0
Requires-Dist: pillow>=10.4.0
Requires-Dist: rich>=14.0.0
Requires-Dist: rich-pyfiglet
Requires-Dist: fastmcp>=2.11.0
Requires-Dist: nats-py>=2.10.0
Requires-Dist: nkeys
Requires-Dist: PyNaCl>=1.5.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: diskcache
Requires-Dist: python-frontmatter>=1.1.0
Requires-Dist: prompt-toolkit>=3.0.50
Requires-Dist: aiofiles>=24.1.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: ddgs>=9.5.2
Requires-Dist: crawl4ai>=0.5.0
Requires-Dist: matplotlib>=3.10.3
Requires-Dist: cloudpickle>=3.0.0
Requires-Dist: PyMuPDF>=1.25.5
Requires-Dist: lancedb>=0.20.0
Requires-Dist: jupyter-client>=8.0.0
Requires-Dist: ipykernel>=6.25.0
Requires-Dist: nbformat>=5.10.0
Requires-Dist: jedi>=0.19.0
Requires-Dist: tree-sitter>=0.24.0
Requires-Dist: tree-sitter-python>=0.24.0
Requires-Dist: tree-sitter-javascript>=0.24.0
Requires-Dist: nats-server-bin>=2.10.0
Requires-Dist: slack-sdk
Requires-Dist: slack-bolt
Requires-Dist: python-telegram-bot>=21.3
Requires-Dist: discord.py>=2.5
Requires-Dist: lark-oapi
Requires-Dist: requests>=2.0
Requires-Dist: cryptography>=42.0.0
Requires-Dist: websocket-client>=1.8
Requires-Dist: qrcode
Provides-Extra: dev
Requires-Dist: pytest>=8.3.4; extra == "dev"
Requires-Dist: pytest-asyncio>=0.25.0; extra == "dev"
Requires-Dist: pytest-timeout>=2.3.1; extra == "dev"
Provides-Extra: r
Requires-Dist: rpy2>=3.5.0; extra == "r"
Provides-Extra: knowledge
Requires-Dist: llama-index-core>=0.11.0; extra == "knowledge"
Requires-Dist: llama-index-llms-openai; extra == "knowledge"
Requires-Dist: llama-index-vector-stores-qdrant>=0.3.0; extra == "knowledge"
Requires-Dist: qdrant-client>=1.12.0; extra == "knowledge"
Requires-Dist: llama-index-embeddings-openai>=0.2.0; extra == "knowledge"
Requires-Dist: llama-index-readers-file>=0.2.0; extra == "knowledge"
Requires-Dist: docx2txt>=0.8; extra == "knowledge"
Requires-Dist: fastembed>=0.2.0; extra == "knowledge"
Requires-Dist: llama-index-postprocessor-flashrank-rerank>=0.2.0; extra == "knowledge"
Requires-Dist: llama-index-postprocessor-cohere-rerank; extra == "knowledge"
Requires-Dist: nbconvert>=7.16.0; extra == "knowledge"
Dynamic: license-file

<div align="center">

<img src="docs/source/_static/pantheon-github-banner.png" alt="PantheonOS — A framework for building evolvable and distributed multi-agent systems." width="100%" />

[Official Site][official-site] · [Online App][online-app] · [Desktop App][desktop-release-link] · [Documents][docs] · [Feedback][github-issues-link]

[official-site]: https://pantheonos.stanford.edu/
[online-app]: https://app.pantheonos.stanford.edu/
[docs]: https://pantheonos.readthedocs.io/en/latest/

</div>

<div align="center">

<!-- SHIELD GROUP -->

[![][website-shield]][website-link]
[![][online-app-shield]][online-app]
[![][desktop-shield]][desktop-release-link]
[![][store-shield]][store-link]
[![][manuscript-shield]][manuscript-link]
[![][slack-shield]][slack-link]
[![][discord-shield]][discord-link]
[![][x-shield]][x-link]
<br/>
[![][github-contributors-shield]][github-contributors-link]
[![][github-forks-shield]][github-forks-link]
[![][github-stars-shield]][github-stars-link]
[![][github-issues-shield]][github-issues-link]
[![][github-license-shield]][github-license-link]
[![][pypi-shield]][pypi-link]
[![][python-shield]][python-link]
[![][status-shield]]()

</div>

## `1` [What is PantheonOS?](#1-what-is-pantheonos)

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](https://app.pantheonos.stanford.edu/#/store)** — A community marketplace with 1,000+ curated agents, teams, and skills for biomedical AI, installable via UI or CLI

## `2` [Quick Start & Community](#2-quick-start--community)

| | |
| :--- | :--- |
| [![][online-app-shield]][online-app] | Play with our Web UI! |
| [![][desktop-shield]][desktop-release-link] | Download the latest desktop app release. |
| [![][store-shield]][store-link] | Browse 1,000+ agents, teams, and skills! |
| [![][pypi-shield]][pypi-link] | `pip install pantheon-agents` |
| [![][slack-shield-badge]][slack-link] | Join our Slack community! |
| [![][discord-shield-badge]][discord-link] | Join our Discord community! |

## `3` [Installation](#3-installation)

### Desktop App

Download the latest Pantheon Desktop app:

- [Desktop release page][desktop-release-link]

Open the release page to download the latest version for your platform.

### Using uv (Recommended)

[uv](https://github.com/astral-sh/uv) is a fast Python package manager that handles dependencies efficiently.

```bash
# 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 claw       # PantheonClaw mobile gateway channels
uv sync --extra r          # R language support (requires R installed)
```

### Using pip

```bash
# Basic installation
pip install pantheon-agents

# With optional dependencies
pip install "pantheon-agents[knowledge]"  # RAG/vector search support
pip install "pantheon-agents[claw]"       # PantheonClaw mobile gateway channels
```

### Development Installation

```bash
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](https://img.shields.io/docker/pulls/nanguage/pantheon-agents)](https://hub.docker.com/r/nanguage/pantheon-agents)

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

```bash
# 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](https://github.com/aristoteleo/PantheonOS/tree/main/pantheon-agents/docker).

## `4` [Usage](#4-usage)

### CLI Mode

```bash
# Start the interactive REPL
pantheon cli
```

### Chatroom UI

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

### API Usage

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

## `5` [Contributing](#5-contributing)

Contributions of all types are more than welcome! Whether it's publishing skills to the [Pantheon Store][store-link] or contributing code, feel free to check out our GitHub [Issues][github-issues-link] to dive in.

[![][pr-welcome-shield]][pr-welcome-link]
[![][store-contribute-shield]][store-link]

## License

This project is [BSD 2-Clause](./LICENSE) licensed.

Copyright © 2026 [Qiu Lab](https://www.devo-evo.com/).

<!-- LINK GROUP -->

[github-contributors-link]: https://github.com/aristoteleo/PantheonOS/graphs/contributors
[github-contributors-shield]: https://img.shields.io/github/contributors/aristoteleo/PantheonOS?color=c4f042&labelColor=black&style=flat-square
[github-forks-link]: https://github.com/aristoteleo/PantheonOS/network/members
[github-forks-shield]: https://img.shields.io/github/forks/aristoteleo/PantheonOS?color=8ae8ff&labelColor=black&style=flat-square
[github-issues-link]: https://github.com/aristoteleo/PantheonOS/issues
[github-issues-shield]: https://img.shields.io/github/issues/aristoteleo/PantheonOS?color=ff80eb&labelColor=black&style=flat-square
[github-license-link]: https://github.com/aristoteleo/PantheonOS/blob/main/LICENSE
[github-license-shield]: https://img.shields.io/badge/license-BSD--2--Clause-white?labelColor=black&style=flat-square
[github-stars-link]: https://github.com/aristoteleo/PantheonOS/network/stargazers
[github-stars-shield]: https://img.shields.io/github/stars/aristoteleo/PantheonOS?color=ffcb47&labelColor=black&style=flat-square

[website-link]: https://pantheonos.stanford.edu/
[website-shield]: https://img.shields.io/badge/official--website-55b467?labelColor=black&logo=safari&logoColor=white&style=flat-square
[desktop-release-link]: https://github.com/aristoteleo/PantheonOS/releases/tag/desktop-latest
[desktop-shield]: https://img.shields.io/badge/desktop-download-1f6feb?labelColor=black&logo=github&logoColor=white&style=flat-square
[manuscript-link]: https://pantheonos.stanford.edu/paper
[manuscript-shield]: https://img.shields.io/badge/manuscript-read-red?labelColor=black&logo=arxiv&logoColor=white&style=flat-square
[x-link]: https://x.com/PantheonOS
[x-shield]: https://img.shields.io/badge/X-follow-000000?labelColor=black&logo=x&logoColor=white&style=flat-square
[bluesky-link]: https://bsky.app/profile/pantheonos.bsky.social
[bluesky-shield]: https://img.shields.io/badge/bluesky-follow-0085FF?labelColor=black&logo=bluesky&logoColor=white&style=flat-square
[online-app-shield]: https://img.shields.io/badge/online%20app-try%20now-369eff?labelColor=black&logo=googlechrome&logoColor=white&style=flat-square
[discord-link]: https://discord.com/invite/UHsuzAyz
[discord-shield]: https://img.shields.io/badge/discord-join-5865F2?labelColor=black&logo=discord&logoColor=white&style=flat-square
[discord-shield-badge]: https://img.shields.io/badge/discord-join-5865F2?labelColor=black&logo=discord&logoColor=white&style=flat-square

[slack-link]: https://join.slack.com/t/pantheonos/shared_invite/zt-3bmj318fo-vAWtJA01VkcqyHsleduFjQ
[slack-shield]: https://img.shields.io/badge/slack-join-4A154B?labelColor=black&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik01LjA0MiAxNS4xNjVhMi41MjggMi41MjggMCAwIDEtMi41MiAyLjUyM0EyLjUyOCAyLjUyOCAwIDAgMSAwIDE1LjE2NWEyLjUyNyAyLjUyNyAwIDAgMSAyLjUyMi0yLjUyaDIuNTJ2Mi41MnptMS4yNzEgMGEyLjUyNyAyLjUyNyAwIDAgMSAyLjUyMS0yLjUyIDIuNTI3IDIuNTI3IDAgMCAxIDIuNTIxIDIuNTJ2Ni4zMTNBMi41MjggMi41MjggMCAwIDEgOC44MzQgMjRhMi41MjggMi41MjggMCAwIDEtMi41MjEtMi41MjJ2LTYuMzEzek04LjgzNCA1LjA0MmEyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMS0yLjUyQTIuNTI4IDIuNTI4IDAgMCAxIDguODM0IDBhMi41MjggMi41MjggMCAwIDEgMi41MjEgMi41MjJ2Mi41Mkg4LjgzNHptMCAxLjI3MWEyLjUyOCAyLjUyOCAwIDAgMSAyLjUyMSAyLjUyMSAyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMSAyLjUyMUgyLjUyMkEyLjUyOCAyLjUyOCAwIDAgMSAwIDguODM0YTIuNTI4IDIuNTI4IDAgMCAxIDIuNTIyLTIuNTIxaDYuMzEyem0xMC4xMjIgMi41MjFhMi41MjggMi41MjggMCAwIDEgMi41MjItMi41MjFBMi41MjggMi41MjggMCAwIDEgMjQgOC44MzRhMi41MjggMi41MjggMCAwIDEtMi41MjIgMi41MjFoLTIuNTIyVjguODM0em0tMS4yNjggMGEyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMyAyLjUyMSAyLjUyNyAyLjUyNyAwIDAgMS0yLjUyLTIuNTIxVjIuNTIyQTIuNTI3IDIuNTI3IDAgMCAxIDE1LjE2NSAwYTIuNTI4IDIuNTI4IDAgMCAxIDIuNTIzIDIuNTIydjYuMzEyem0tMi41MjMgMTAuMTIyYTIuNTI4IDIuNTI4IDAgMCAxIDIuNTIzIDIuNTIyQTIuNTI4IDIuNTI4IDAgMCAxIDE1LjE2NSAyNGEyLjUyNyAyLjUyNyAwIDAgMS0yLjUyLTIuNTIydi0yLjUyMmgyLjUyem0wLTEuMjY4YTIuNTI3IDIuNTI3IDAgMCAxLTIuNTItMi41MjMgMi41MjcgMi41MjcgMCAwIDEgMi41Mi0yLjUyaDYuMzEzQTIuNTI4IDIuNTI4IDAgMCAxIDI0IDE1LjE2NWEyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMiAyLjUyM2gtNi4zMTN6Ii8+PC9zdmc+&style=flat-square
[slack-shield-badge]: https://img.shields.io/badge/slack-join-4A154B?labelColor=black&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik01LjA0MiAxNS4xNjVhMi41MjggMi41MjggMCAwIDEtMi41MiAyLjUyM0EyLjUyOCAyLjUyOCAwIDAgMSAwIDE1LjE2NWEyLjUyNyAyLjUyNyAwIDAgMSAyLjUyMi0yLjUyaDIuNTJ2Mi41MnptMS4yNzEgMGEyLjUyNyAyLjUyNyAwIDAgMSAyLjUyMS0yLjUyIDIuNTI3IDIuNTI3IDAgMCAxIDIuNTIxIDIuNTJ2Ni4zMTNBMi41MjggMi41MjggMCAwIDEgOC44MzQgMjRhMi41MjggMi41MjggMCAwIDEtMi41MjEtMi41MjJ2LTYuMzEzek04LjgzNCA1LjA0MmEyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMS0yLjUyQTIuNTI4IDIuNTI4IDAgMCAxIDguODM0IDBhMi41MjggMi41MjggMCAwIDEgMi41MjEgMi41MjJ2Mi41Mkg4LjgzNHptMCAxLjI3MWEyLjUyOCAyLjUyOCAwIDAgMSAyLjUyMSAyLjUyMSAyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMSAyLjUyMUgyLjUyMkEyLjUyOCAyLjUyOCAwIDAgMSAwIDguODM0YTIuNTI4IDIuNTI4IDAgMCAxIDIuNTIyLTIuNTIxaDYuMzEyem0xMC4xMjIgMi41MjFhMi41MjggMi41MjggMCAwIDEgMi41MjItMi41MjFBMi41MjggMi41MjggMCAwIDEgMjQgOC44MzRhMi41MjggMi41MjggMCAwIDEtMi41MjIgMi41MjFoLTIuNTIyVjguODM0em0tMS4yNjggMGEyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMyAyLjUyMSAyLjUyNyAyLjUyNyAwIDAgMS0yLjUyLTIuNTIxVjIuNTIyQTIuNTI3IDIuNTI3IDAgMCAxIDE1LjE2NSAwYTIuNTI4IDIuNTI4IDAgMCAxIDIuNTIzIDIuNTIydjYuMzEyem0tMi41MjMgMTAuMTIyYTIuNTI4IDIuNTI4IDAgMCAxIDIuNTIzIDIuNTIyQTIuNTI4IDIuNTI4IDAgMCAxIDE1LjE2NSAyNGEyLjUyNyAyLjUyNyAwIDAgMS0yLjUyLTIuNTIydi0yLjUyMmgyLjUyem0wLTEuMjY4YTIuNTI3IDIuNTI3IDAgMCAxLTIuNTItMi41MjMgMi41MjcgMi41MjcgMCAwIDEgMi41Mi0yLjUyaDYuMzEzQTIuNTI4IDIuNTI4IDAgMCAxIDI0IDE1LjE2NWEyLjUyOCAyLjUyOCAwIDAgMS0yLjUyMiAyLjUyM2gtNi4zMTN6Ii8+PC9zdmc+&style=flat-square

[pypi-link]: https://pypi.org/project/pantheon-agents
[pypi-shield]: https://img.shields.io/pypi/v/pantheon-agents?color=369eff&labelColor=black&logo=pypi&logoColor=white&style=flat-square

[python-link]: https://www.python.org/downloads/
[python-shield]: https://img.shields.io/badge/python-3.10%2B-3776AB?labelColor=black&style=flat-square&logo=python&logoColor=white
[status-shield]: https://img.shields.io/badge/status-beta-orange?labelColor=black&style=flat-square


[store-link]: https://app.pantheonos.stanford.edu/#/store
[store-shield]: https://img.shields.io/badge/store-explore-8B5CF6?labelColor=black&logo=googlechrome&logoColor=white&style=flat-square

[store-contribute-shield]: https://img.shields.io/badge/store-contribute-8B5CF6?labelColor=black&logo=googlechrome&logoColor=white&style=for-the-badge

[pr-welcome-link]: https://github.com/aristoteleo/PantheonOS/pulls
[pr-welcome-shield]: https://img.shields.io/badge/👌_pr_welcome-%E2%86%92-ffcb47?labelColor=black&style=for-the-badge
