{"id":45250907,"url":"https://github.com/aristoteleo/pantheon-cli","last_synced_at":"2026-02-20T22:41:28.023Z","repository":{"id":311079160,"uuid":"1029282950","full_name":"aristoteleo/pantheon-cli","owner":"aristoteleo","description":"Pantheon-CLI, our first release of PantheonOS, the AgentOS that re-imagines Science","archived":false,"fork":false,"pushed_at":"2026-02-13T23:51:08.000Z","size":8224,"stargazers_count":221,"open_issues_count":8,"forks_count":17,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-14T05:31:17.064Z","etag":null,"topics":["agent","agentos","cli","pantheonos","singlecell","spatial-transcriptomics"],"latest_commit_sha":null,"homepage":"https://pantheonos.stanford.edu/cli/docs/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aristoteleo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-30T19:54:44.000Z","updated_at":"2026-02-13T23:51:12.000Z","dependencies_parsed_at":"2025-08-22T02:33:28.784Z","dependency_job_id":"f0876ff0-e8fa-4647-a0dc-b068ad7f7ff4","html_url":"https://github.com/aristoteleo/pantheon-cli","commit_stats":null,"previous_names":["aristoteleo/pantheon-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/aristoteleo/pantheon-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aristoteleo%2Fpantheon-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aristoteleo%2Fpantheon-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aristoteleo%2Fpantheon-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aristoteleo%2Fpantheon-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aristoteleo","download_url":"https://codeload.github.com/aristoteleo/pantheon-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aristoteleo%2Fpantheon-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29667095,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T19:49:36.704Z","status":"ssl_error","status_checked_at":"2026-02-20T19:44:05.372Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentos","cli","pantheonos","singlecell","spatial-transcriptomics"],"created_at":"2026-02-20T22:41:27.331Z","updated_at":"2026-02-20T22:41:28.006Z","avatar_url":"https://github.com/aristoteleo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\u003c!-- Banner --\u003e\n\u003cp align=\"center\"\u003e\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n  \u003cimg src=\"assets/readme_banner.png#gh-dark-mode-only\" alt=\"Pantheon ASCII (dark)\" /\u003e\n  \u003cimg src=\"assets/readme_banner.png#gh-light-mode-only\" alt=\"Pantheon ASCII (light)\" /\u003e\n\n\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n# Pantheon CLI\n\n***We're not just building another CLI tool.  \nWe're defining how scientists interact with data in the AI era.***\n\n**The first fully open-source, infinitely extensible scientific \"chat analysis\" human like framework**\n\n**English** · [简体中文](./README.zh-CN.md) · [Official Site][official-site] · [Changelog][changelog] · [Documents][docs] · [Blog][blog] · [Feedback][github-issues-link]\n\n[official-site]: https://pantheonos.stanford.edu/\n[changelog]: https://pantheonos.stanford.edu/cli/docs/release-notes\n[docs]: https://pantheonos.stanford.edu/cli/docs/intro/getting-started\n[blog]: https://pantheonos.stanford.edu/news\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n\u003c!-- SHIELD GROUP --\u003e\n\n[![][github-release-shield]][github-release-link]\n[![][vercel-shield]][vercel-link]\n[![][discord-shield]][discord-link]\u003cbr/\u003e\n[![][github-contributors-shield]][github-contributors-link]\n[![][github-forks-shield]][github-forks-link]\n[![][github-stars-shield]][github-stars-link]\n[![][github-issues-shield]][github-issues-link]\n[![][github-license-shield]][github-license-link]\u003cbr\u003e\n\n\n\u003ctable align=\"center\" width=\"100%\" style=\"border: none; border-collapse: collapse; margin: 30px 0;\"\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\" align=\"center\" style=\"vertical-align: top; padding: 20px;\"\u003e\n\n#### 🖥️ **CLI Interface**\n**Terminal-Based Development**\n\n\u003cdiv align=\"center\"\u003e\n\n  \u003cimg src=\"https://github.com/Starlitnightly/ImageStore/blob/main/pantheon_image/case_terminal_math.gif\" alt=\"CLI Interface Demo\" width=\"100%\" style=\"border-radius: 10px; box-shadow: 0 8px 20px rgba(45,55,72,0.3); margin: 15px 0;\"/\u003e\n\n  \u003cdiv style=\"background: linear-gradient(135deg, #2D3748 0%, #4A5568 100%); border-radius: 12px; padding: 15px; margin: 15px 0; color: white;\"\u003e\n    \u003cstrong\u003eScientific Terminal Experience\u003c/strong\u003e\u003cbr/\u003e\n    \u003csmall\u003eAll Claude Code Function\u003cbr/\u003eAnalyst-friendly interface\u003cbr/\u003eReal-time progress tracking\u003c/small\u003e\n  \u003c/div\u003e\n\n  *Open-source CLI built for collaborative analysis, local-first execution, and seamless integration with modern DevOps.*\n\u003c/div\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"50%\" align=\"center\" style=\"vertical-align: top; padding: 20px;\"\u003e\n\n#### 🌐 **Notebook Interface**\n**Notebook Interactive Experience**\n\n\u003cdiv align=\"center\"\u003e\n\n  \u003cimg src=\"https://github.com/Starlitnightly/ImageStore/blob/main/pantheon_image/case_notebook_math.gif\" alt=\"Web Interface Demo\" width=\"100%\" style=\"border-radius: 10px; box-shadow: 0 8px 20px rgba(14,165,233,0.3); margin: 15px 0;\"/\u003e\n\n  \u003cdiv style=\"background: linear-gradient(135deg, #0EA5E9 0%, #00D4FF 100%); border-radius: 12px; padding: 15px; margin: 15px 0; color: white;\"\u003e\n  \u003cstrong\u003e📓 Interactive Notebook Integration\u003c/strong\u003e\u003cbr/\u003e\n  \u003csmall\u003eStep-by-step execution\u003cbr/\u003eReal-time visualization\u003cbr/\u003eSeamless CLI integration\u003c/small\u003e\n\u003c/div\u003e\n\n\n  *Pantheon-CLI meets JupyterLab—bridging natural language, code, and data in one unified notebook experience.*\n\u003c/div\u003e\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n**Share Pantheon-CLI Repository**\n\n[![][share-x-shield]][share-x-link]\n[![][share-telegram-shield]][share-telegram-link]\n[![][share-whatsapp-shield]][share-whatsapp-link]\n[![][share-reddit-shield]][share-reddit-link]\n[![][share-weibo-shield]][share-weibo-link]\n[![][share-mastodon-shield]][share-mastodon-link]\n[![][share-linkedin-shield]][share-linkedin-link]\n\n\n[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)\n[![Status: Beta](https://img.shields.io/badge/Status-Beta-orange.svg)]()\n[![AI-Native](https://img.shields.io/badge/AI-Native-purple.svg)]()\n\n\n\n\n\n\u003c/div\u003e\n\n\n## `1` [What is Pantheon-CLI?](#1-what-is-pantheon-cli)\n\nPantheon-CLI is the **first fully open-source \"chat analysis\" human-like framework** built specifically for scientific research. We are defining a new way for researchers to interact with data in the AI era.\n\n### **PhD-Level Scientific Assistant**\n- Pantheon-CLI is the first command-line intelligent (CLI) agent assistant for complex real-world analysis like human, capable of handling PhD-level single-cell and spatial genomics tasks. This is not just a tool—**it's an AI scientist on your research team**.\n\n### **Mixed Programming** \n- With Pantheon-CLI, you can work within the same environment to:\n  - Write Python code on the first line\n  - Use natural language descriptions on the next line  \n  - Even mix in R/Julia languages\n\nAll scientists need only focus on the **explore**, without switching between different tools and environments.\n\n## `2` [Quick Start \u0026 Join our Community](#)\n\nWe are a group of scientist-engineers, building the first open-source Python-based CLI that redefines how humans interact with data. By embracing an Agent-driven, conversational workflow, Pantheon-CLI aims to provide researchers and developers across disciplines with a more transparent, reproducible, and future-proof ecosystem for data science.\n\nWhether you are a biologist, financial analyst, social scientist, or machine learning researcher, Pantheon-CLI will be your next-generation playground for analysis. Please note that Pantheon-CLI is still under active development, and we warmly welcome your feedback and contributions.\n\n| [![](https://img.shields.io/pypi/v/pantheon-cli)](https://pypi.org/project/pantheon-cli)   | `pip install 'pantheon-cli[notebook]'`                           |\n| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |\n| [![][slack-shield-badge]](https://join.slack.com/t/pantheonos/shared_invite/zt-3bmj318fo-vAWtJA01VkcqyHsleduFjQ)             | Join our Slack community! Connect with developers and other enthusiastic users of Pantheon. |\n| [![][discord-shield-badge]](https://discord.gg/3yjHaPUn)        | Join our Discord community! Connect with developers and other enthusiastic users of Pantheon. |\n\n[slack-shield-badge]: https://img.shields.io/badge/Slack-join-blue?logo=slack\u0026style=flat-square  \n[slack-link]: https://pantheonos.slack.com/ssb/redirect  \n\n[discord-shield-badge]: https://img.shields.io/badge/Discord-join-blue?logo=discord\u0026style=flat-square  \n[discord-link]: https://discord.com/invite/74yzAGYW  \n\n## `3` [Features](#)\n\nTransform your data analysis workflow with Pantheon-CLI’s open-source power, built for seamless language integration, effortless data analysis, and next-generation discovery.\n\n### 3.1 Chat with Data\n\n![](assets/feature_1.jpg)\n\n- With Pantheon-CLI, you can process any local data, not limited to text csv, excel, including anndata, pkl, torch, and any other Python/R/Julia-supported data formats. \n- You don’t need to upload any data to a server—the analysis power depends entirely on your own computer. You can even install Pantheon-CLI on a server to unlock unlimited possibilities for data analysis.\n\n### 3.2 Mixed Programming\n\n![](assets/feature_2.jpg)\n\n- In Pantheon-CLI, all variables are kept in the environment. We have broken through the limitations of \ntraditional programming. You can enter natural language at any time to program, and the CLI will automatically generate Python/R/Julia code to run.\n- This is the world’s first Agent CLI with variable support. During the coding process, you can input natural language at any time, and Pantheon-CLI will automatically carry out any analysis you want.\n\n### 3.3 MCP Integration\n\n![](assets/feature_3.jpg)\n\n- Through Pantheon-CLI, we have created an assistant for human-computer interaction that has all the capabilities of a human operating a computer: reading files, creating files, running commands, generating code, and reading web pages.\n- Unlike traditional agents, we have implemented nearly all the functionalities of Claude Code and further optimized them—aiming to make Pantheon-CLI better suited for data analysis rather than pure code programming.\n\n### 3.4 Human Behaviours\n\n![](assets/feature_4.jpg)\n\n- In Pantheon-CLI, it can read web tutorials and PDF papers, just like human scientists do before analyzing data in a specific field. Then it can start planning the analysis.\n- Feeding documents or tutorials into GPT often leads to better outputs, but not all web content is accessible. We have redesigned a more powerful web fetch feature to replicate, as closely as possible, everything a human would do before analyzing data.\n\n### 3.5 Task Planning\n\n![](assets/feature_5.jpg)\n\n- Learn from papers and automatically plan and build scientific agents in Pantheon-CLI. Learn the Method section of papers and mimic human experts to build step-by-step agents.\n- For a data science task, the common approach for Agents today is to plan and execute step by step. However, this relies on steps predefined by humans. In Pantheon-CLI, it automatically learns and plans the analysis workflow from papers or tutorials. How is that any different from how humans do it?\n\n### 3.6 Multi AI Provider\n\n![](assets/feature_6.jpg)\n\n- Pantheon-CLI supports major LLM providers, including OpenAI, Anthropic, Gemini, Deepseek, Qwen, and more, so you are not limited to any particular model.\n- This may look simple, but it’s a highly practical feature: we support all major large models, without requiring a Claude Code–style API—any LLM API is supported.\n\n### 3.7 Local LLM Support\n\n![](assets/feature_7.jpg)\n\n- To account for certain data privacy compliance requirements, Pantheon-CLI can analyze data completely offline using a local large model based on open sourced models, such as deepseek, ollama or gpt-oss.\n- Analyze data and run model locally as an important advantage of Pantheon-CLI.\n\n### 3.8 Multi RAG Suport\n\n![](assets/feature_rag.jpg)\n\n- In Pantheon-CLI, we provide a complete pre-learning RAG solution. By leveraging powerful web crawlers to gather all available information from documents, we build an additional “brain” which then matches the user’s intent to this “brain” to generate more credible outputs.\n- Although RAG is still subject to much debate, people can’t always find the right tutorial to use as accurate input. In such cases, RAG becomes highly valuable—after all, extremely long contexts also consume a lot of tokens. We will later release a larger RAG database for anyone to download.\n\n\n### 3.9 Biology Support\n\n![](assets/feature_8.jpg)\n\n- Leveraging our expertise in biological omics analysis, we have predefined a series of built-in toolsets for omics. These can help you complete upstream sequencing alignment, downstream annotation, and differential analysis — and even fully reproduce all analyses from a biological research paper.\n\n### 3.10 Notebook Support\n\n![](assets/feature_notebook.png)\n\n- Imagine this: from now on, when analyzing data in Notebook, you have a requirement but don't want to sift through complicated documents. All you need to do is have a conversation, and the analysis is done in an instant.\n- Not just for writing code, it can also run and revise code automatically to generate the correct result, and even operate on files and study from website — beyond what any other tool can do.\n\n\n## `4` [Detailed Installation](#)\n\n\n### 4.1 Installation\n\n#### Simple Installation (Recommended)\n\n```bash\npip install 'pantheon-cli[notebook]'\n```\n\n#### Development Installation\n```bash\n# Install from source (recommended for development)\ngit clone https://github.com/aristoteleo/pantheon-cli.git\ncd Pantheon-cli\npip install -e .\n\n# Make sure dependencies are installed\npip install pantheon-agents pantheon-toolsets\n```\n\n#### Verify Installation\n```bash\npantheon-cli --version\n```\n\n**Note**: Pantheon-CLI requires both `pantheon-agents` and `pantheon-toolsets` to be installed. These provide the core agent functionality and distributed toolsets respectively.\n\n\n\n### 4.2 Basic Usage\n\n#### First Launch\n```bash\n# Start Pantheon-CLI\npantheon-cli\n```\n\nThe system will prompt you to configure an API key or select a local model. For quick experience, you can configure an OpenAI or Anthropic API key.\n\n#### API Key Configuration\n```bash\n# Once the CLI is running, setup your API keys:\n/api-key list  # List current API keys and their sources\n\n# Set API keys globally (available in any directory):\n/api-key openai sk-your-key-here\n/api-key anthropic sk-your-key-here\n/api-key deepseek sk-your-key-here\n\n# Set API keys locally (only for current project):\n/api-key openai sk-your-key-here --local\n```\n\n#### Configuration Management\n\nPantheon-CLI supports both **global** and **local** API key storage:\n\n- **Global Configuration** (`~/.pantheon/config.json`): \n  - API keys saved here are available in any directory\n  - Perfect for personal API keys you use across all projects\n  - Use `/api-key \u003cprovider\u003e \u003ckey\u003e` (default behavior)\n\n- **Local Configuration** (`.pantheon_config.json` in current directory):\n  - API keys saved here are only available in the current project\n  - Useful for project-specific keys or team environments\n  - Use `/api-key \u003cprovider\u003e \u003ckey\u003e --local`\n\nPriority order: Environment Variables \u003e Local Config \u003e Global Config\n\n#### Launch Options\n```bash\n# Start with default settings\npantheon-cli\n\n# Start with different model\npantheon-cli --model claude-sonnet-4-20250514\n\n# Start without RAG database\npantheon-cli --disable_rag\n\n# Start with custom workspace\npantheon-cli --workspace /path/to/project\n\n# Start with external toolsets\npantheon-cli --disable_ext False --ext_dir ./ext_toolsets\n\n# Build RAG database (requires SCRAPER_API_KEY environment variable)\nexport SCRAPER_API_KEY=2eaca840...\npantheon-cli --build-rag  # Use default config and output\npantheon-cli --build-rag custom_output_dir  # Custom output directory\npantheon-cli --build-rag --rag-config custom.yaml  # Custom config file\npantheon-cli --build-rag output_dir --rag-config custom.yaml  # Both custom\n```\n\n### 4.3 With RAG Database\n\nIf you have a RAG database prepared:\n\n```bash\npantheon-cli --rag_db path/to/rag/database\n```\n\nDefault RAG database location: `tmp/pantheon_cli_tools_rag/pantheon-cli-tools`.\n\n**Note that, if a default RAG database is not found, the CLI will automatically run with RAG functionality disabled.**\n\n## `5` [RAG System Setup](#5-rag-system-setup)\n\n### 5.1 Prerequisites\n\nBefore building the RAG database, you need:\n- **OpenAI API Key**: For generating text embeddings\n- **ScrapingBee API Key**: For web crawling documentation\n\n### 5.2 Quick Build with Global API Keys\n\nThe easiest way to build the RAG database is using the built-in command that automatically uses your global API keys:\n\n```bash\n# First, ensure you have required API keys configured\npantheon-cli  # Start CLI\n/api-key openai sk-your-key-here  # Set OpenAI key globally\nexit  # Exit CLI\n\n# Set the scraper API key (required for web crawling)\nexport SCRAPER_API_KEY=2eaca840...\n\n# Then build the RAG database\npantheon-cli --build-rag\n\n# Or specify options\npantheon-cli --build-rag /path/to/rag/output  # Custom output directory\npantheon-cli --build-rag --rag-config my_config.yaml  # Custom config\npantheon-cli --build-rag /path/to/rag/output --rag-config my_config.yaml  # Both\n```\n\n### 5.3 Manual Build (Alternative Method)\n\nTo use the RAG knowledge base, build it from the provided configuration:\n\n```bash\n# Set required environment variables\nexport OPENAI_API_KEY=sk-your-openai-key-here\nexport SCRAPER_API_KEY=...\n\n# Build the RAG database\npython -m pantheon.toolsets.utils.rag build \\\n    pantheon/cli/rag_system_config.yaml \\\n    tmp/pantheon_cli_tools_rag\n```\n\nThis creates a vector database at `tmp/pantheon_cli_tools_rag/pantheon-cli-tools` with genomics tools documentation.\n\n\n### 5.4 Command Line Options\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `--rag_db` | Path to RAG database | `tmp/pantheon_cli_tools_rag/pantheon-cli-tools` |\n| `--model` | AI model to use | Loaded from config or `gpt-4.1` |\n| `--agent_name` | Name of the agent | `general_bot` |\n| `--workspace` | Working directory | Current directory |\n| `--instructions` | Custom instructions | Built-in instructions |\n| `--disable_rag` | Disable RAG toolset | `False` |\n| `--disable_web` | Disable web toolset | `False` |\n| `--disable_dr` | Disable domain research toolset | `False` |\n| `--disable_notebook` | Disable notebook toolset | `False` |\n| `--disable_r` | Disable R interpreter toolset | `False` |\n| `--disable_julia` | Disable Julia interpreter toolset | `False` |\n| `--disable_code_validator` | Disable code validation toolset | `False` |\n| `--disable_bio` | Disable bio analysis toolsets | `False` |\n| `--disable_ext` | Disable external toolsets loader | `True` |\n| `--ext_toolsets` | Comma-separated list of external toolsets to load | All available |\n| `--ext_dir` | Directory containing external toolsets | `./ext_toolsets` |\n\n\n## `6` [Available Tools](#6-available-tools)\n\n### Core Tools (Always Enabled)\n- **Shell**: System commands and genomics tools with auto-installer\n- **Python**: Data analysis and visualization (pandas, matplotlib, scanpy)\n- **R**: Statistical analysis and Seurat single-cell workflows with sample data\n- **Julia**: High-performance scientific computing (DataFrames.jl, Plots.jl, DifferentialEquations.jl)\n- **File Editor**: Read, edit, and create files with diffs\n- **Code Search**: Find files (glob), search content (grep), list directories (ls)\n- **Code Validation**: Verify Python code, commands, function calls, and detect common errors\n- **Todo**: Claude Code-style task management with smart task breakdown and auto-progression\n- **Generator**: AI-powered external toolset creation for any domain\n- **Bio Tools**: Comprehensive bioinformatics analysis pipelines (ATAC-seq, RNA-seq, etc.)\n\n### Optional Tools\n- **RAG**: Vector-based knowledge search with built-in scientific knowledge\n- **Web**: Intelligent web operations with automatic URL intent analysis\n- **Notebook**: Jupyter notebook editing (no execution)\n - **Domain Research**: OmicVerse-backed domain research with live web retrieval and demo fallback\n\nQuick example (Domain Research via agent):\n- Ask: \"Research PBMC annotation best practices using live web and cite sources\"\n- The agent can call `domain_research.run_research` under the hood.\n\nDate constraints and PubMed usage\n\n- You can include date constraints in your prompt that the agent will translate for web search backends:\n  - `date:\u003e=YYYY` becomes an `after:YYYY` token for web queries and a PubMed date range when using `web:pubmed`.\n  - `date:\u003c=YYYY[-MM[-DD]]` becomes a `before:YYYY[-MM[-DD]]` token.\n  - Example: \"Research recent PBMC annotation best practices (date:\u003e=2022 date:\u003c=2024-06-01) using PubMed\".\n- To prefer PubMed results, ask explicitly (e.g., \"use PubMed\") or start the Domain Research toolset with `backend=\"web:pubmed\"`.\n\nInstitution Access Flow\n\n- When Domain Research detects paywalled sources, the CLI lists them and offers to open links.\n- Set `INSTITUTION_PROXY_URL` to your library proxy (e.g., `https://libproxy.school.edu/login?url=`) and `ALLOW_BROWSER_OPEN=1` to enable opening links.\n- The prompt lets you open Open Access if available, otherwise via your institution proxy.\n\nInstitution Access Automation\n\n- Flags:\n  - `--institution_proxy_url \u003ctemplate\u003e`: Set your library proxy template, e.g. `https://libproxy.school.edu/login?url=` or `https://libproxy.school.edu/login?url={url}`.\n  - `--save_proxy_url True`: Save proxy template into `.pantheon_config.json` for reuse.\n  - `--access_open \u003cmode\u003e`: Auto-open access links: `oa` (open-access) or `proxy` (institution proxy). Default `none`.\n- Env:\n  - `ALLOW_BROWSER_OPEN=1` to enable opening links from the CLI.\n  - These flags set `INSTITUTION_PROXY_URL` and `ACCESS_OPEN_MODE` for the session.\n\n## `7` [Configuration Files](#7-configuration-files)\n\nPantheon CLI supports project-specific configuration files similar to Claude Code's `CLAUDE.md`:\n\n- **`PANTHEON.md`**: Project-wide configuration, commands, and guidelines (safe to commit)\n- **`PANTHEON.local.md`**: Personal preferences and local settings (add to `.gitignore`)\n\nThese files are automatically discovered in your current directory or any parent directory and integrated into the AI assistant's context.\n\n**Example `PANTHEON.md`:**\n```markdown\n# My Project\n\n## Commands\n- Run analysis: `python scripts/analyze.py`\n- Quick data load: `%adata = sc.read_h5ad('data.h5ad')`\n\n## Guidelines  \n- Use scanpy for Python analysis\n- Use Seurat for R analysis\n```\n\nSee [`CONFIG_FILES.md`](CONFIG_FILES.md) for detailed documentation and examples.\n\n\n\n\n\n## `8` [Architecture](#8-architecture)\n\nPantheon-CLI is built as a standalone package that depends on:\n\n- **pantheon-agents**: Core agent functionality and reasoning\n- **pantheon-toolsets**: Distributed toolsets for various tasks\n- Clean separation of concerns with modular design\n- Enterprise-grade distributed architecture\n\n### Package Structure\n\n```\nPantheon-cli/\n├── pantheon_cli/            # Main package (renamed to avoid conflicts)\n│   ├── __init__.py          # Entry point with cli_main()\n│   ├── cli/                 # CLI implementation\n│   │   ├── core.py          # Main CLI logic with toolset integration\n│   │   └── manager/         # API key and model management\n│   └── repl/                # REPL implementation  \n│       ├── core.py          # REPL core with updated imports\n│       ├── ui.py            # User interface and tool call display\n│       └── bio_handler.py   # Bio command handling\n├── pyproject.toml           # Package configuration\n└── README.md                # This file\n```\n\n\n## `9` [Requirements](#9-requirements)\n\n- Python 3.10+\n- Required packages: `fire`, `rich`, `pantheon-agents`, `pantheon-toolsets`, `hypha_rpc`, `pandas`\n- Optional: R for statistical analysis, Julia for high-performance computing\n\n## `10` [Real Application Scenarios](#10-real-application-scenarios)\n\n### Biomedical Research\n```bash\n\u003e I have a 10x single-cell dataset and want to analyze T cell differentiation trajectories\n\n\u003e Load spatial transcriptomics data and identify gene expression patterns in tissue structures\n\n\u003e Integrate multi-omics data to find disease-related biomarkers\n```\n\n### Data Science Analysis\n```bash\n\u003e Perform time series analysis and forecasting on this sales data\n\n\u003e Build a machine learning model to predict customer churn\n\n\u003e Use deep learning to analyze these medical images\n```\n\n### Teaching and Learning\n```bash\n\u003e Explain the principles of principal component analysis and demonstrate with code\n\n\u003e Compare the performance of different clustering algorithms on this dataset\n\n\u003e Show how to perform statistical analysis for A/B testing\n```\n\n\n## `11` [Why Choose Pantheon-CLI?](#11-why-choose-pantheon-cli)\n\n### Revolutionary Features That Set Us Apart\n\n**Chat with Data Like Never Before**\n- *Traditional*: Limited to simple CSV files, require data preprocessing\n- *Pantheon-CLI*: Process any local data format (anndata, pkl, torch, etc.) directly through conversation\n\n**Mixed Programming Environment**\n- *Traditional*: Switch between Python, R, Julia environments constantly\n- *Pantheon-CLI*: Seamless language integration with persistent variables across all environments\n\n**Advanced Web Intelligence**\n- *Traditional*: Manual web searches and copy-paste workflows\n- *Pantheon-CLI*: Reads tutorials, PDFs, and web content automatically for context-aware analysis\n\n**Human-Like Research Behavior**\n- *Traditional*: Follow rigid predefined analysis pipelines\n- *Pantheon-CLI*: Learns from papers and tutorials, plans analysis like human scientists\n\n**Intelligent RAG Knowledge Base**\n- *Traditional*: Search through scattered documentation manually\n- *Pantheon-CLI*: Built-in scientific knowledge base with automatic document matching\n\n**Multi-AI Provider Support**\n- *Traditional*: Locked into single AI provider (OpenAI, Claude, etc.)\n- *Pantheon-CLI*: Choose from OpenAI, Anthropic, Gemini, DeepSeek, Qwen, and more\n\n**Complete Privacy Control**\n- *Traditional*: Data uploaded to cloud for AI processing\n- *Pantheon-CLI*: Fully offline analysis with local LLMs (Ollama support)\n\n**Domain-Specific Expertise**\n- *Traditional*: Generic AI tools without specialized knowledge\n- *Pantheon-CLI*: Built-in bioinformatics expertise with comprehensive omics analysis pipelines\n\n**Task Planning \u0026 Automation**\n- *Traditional*: Manual step-by-step analysis execution\n- *Pantheon-CLI*: Automatically learns and plans workflows from scientific literature\n\n**Infinite Extensibility**\n- *Traditional*: Limited to pre-built features\n- *Pantheon-CLI*: AI-powered toolset generation for any scientific domain\n\n## `12` [Contributing](#12-contributing)\n\nContributions of all types are more than welcome; if you are interested in contributing code, feel free to check out our GitHub [Issues][github-issues-link] and [Projects][github-project-link] to to dive in and show us what you've got.\n\n\u003e \\[!TIP]\n\u003e\n\u003e We are creating a technology-driven forum, fostering knowledge interaction and the exchange of ideas that may culminate in mutual inspiration and collaborative innovation.\n\u003e\n\u003e Help us make Pantheon-CLI better. Welcome to provide product design feedback, user experience discussions directly to us.\n\u003e\n\u003e **Principal Maintainers:** [@starlitnightly](https://github.com/starlitnightly) [@Nanguage](https://github.com/Nanguage)\n\n[![][pr-welcome-shield]][pr-welcome-link]\n[![][submit-agents-shield]][submit-agents-link]\n[![][submit-plugin-shield]][submit-plugin-link]\n\n\u003cdetails\u003e\u003csummary\u003e\u003ch4\u003e📝 License\u003c/h4\u003e\u003c/summary\u003e\n\n[![][fossa-license-shield]][fossa-license-link]\n\n\u003c/details\u003e\n\nCopyright © 2025 [Qiu Lab](https://www.devo-evo.com/). \u003cbr /\u003e\nThis project is [Apache 2.0](./LICENSE) licensed.\n\n\n[github-contributors-link]: https://github.com/aristoteleo/pantheon-cli/graphs/contributors\n[github-contributors-shield]: https://img.shields.io/github/contributors/aristoteleo/pantheon-cli?color=c4f042\u0026labelColor=black\u0026style=flat-square\n[github-forks-link]: https://github.com/aristoteleo/pantheon-cli/network/members\n[github-forks-shield]: https://img.shields.io/github/forks/aristoteleo/pantheon-cli?color=8ae8ff\u0026labelColor=black\u0026style=flat-square\n[github-issues-link]: https://github.com/aristoteleo/pantheon-cli/issues\n[github-issues-shield]: https://img.shields.io/github/issues/aristoteleo/pantheon-cli?color=ff80eb\u0026labelColor=black\u0026style=flat-square\n[github-license-link]: https://github.com/aristoteleo/pantheon-cli/blob/main/LICENSE\n[github-license-shield]: https://img.shields.io/badge/license-apache%202.0-white?labelColor=black\u0026style=flat-square\n[github-release-link]: https://github.com/aristoteleo/pantheon-cli/releases\n[github-release-shield]: https://img.shields.io/github/v/release/aristoteleo/pantheon-cli?color=369eff\u0026labelColor=black\u0026logo=github\u0026style=flat-square\n[github-project-link]: https://github.com/aristoteleo/pantheon-cli/projects\n[github-release-link]: https://github.com/aristoteleo/pantheon-cli/releases\n[github-release-shield]: https://img.shields.io/github/v/release/aristoteleo/pantheon-cli?color=369eff\u0026labelColor=black\u0026logo=github\u0026style=flat-square\n[github-releasedate-link]: https://github.com/aristoteleo/pantheon-cli/releases\n[github-releasedate-shield]: https://img.shields.io/github/release-date/aristoteleo/pantheon-cli?labelColor=black\u0026style=flat-square\n[github-stars-link]: https://github.com/aristoteleo/pantheon-cli/network/stargazers\n[github-stars-shield]: https://img.shields.io/github/stars/aristoteleo/pantheon-cli?color=ffcb47\u0026labelColor=black\u0026style=flat-square\n[github-trending-shield]: https://trendshift.io/api/badge/repositories/2256\n[github-trending-url]: https://trendshift.io/repositories/2256\n\n\n[vercel-link]: https://pantheonos.stanford.edu/\n[vercel-shield]: https://img.shields.io/badge/vercel-online-55b467?labelColor=black\u0026logo=vercel\u0026style=flat-square\n[discord-link]: https://discord.gg/74yzAGYW\n[discord-shield]: https://img.shields.io/discord/1407066076860125184?color=5865F2\u0026label=discord\u0026labelColor=black\u0026logo=discord\u0026logoColor=white\u0026style=flat-square\n[discord-shield-badge]: https://img.shields.io/discord/1407066076860125184?color=5865F2\u0026label=discord\u0026labelColor=black\u0026logo=discord\u0026logoColor=white\u0026style=for-the-badge\n\n[share-linkedin-link]: https://linkedin.com/feed\n[share-linkedin-shield]: https://img.shields.io/badge/-share%20on%20linkedin-black?labelColor=black\u0026logo=linkedin\u0026logoColor=white\u0026style=flat-square\n[share-mastodon-link]: https://mastodon.social/share?text=Check%20this%20GitHub%20repository%20out%20%F0%9F%A4%AF%20Pantheon%20CLI%20-%20The%20first%20fully%20open-source%2C%20infinitely%20extensible%20scientific%20%22vibe%20analysis%22%20framework.%20An%20AI-driven%20scientific%20intelligent%20agent%20for%20PhD-level%20research%20tasks.%20https://github.com/aristoteleo/pantheon-cli%20%23scientific%20%23AI%20%23bioinformatics\n[share-mastodon-shield]: https://img.shields.io/badge/-share%20on%20mastodon-black?labelColor=black\u0026logo=mastodon\u0026logoColor=white\u0026style=flat-square\n[share-reddit-link]: https://www.reddit.com/submit?title=Check%20this%20GitHub%20repository%20out%20%F0%9F%A4%AF%20Pantheon%20CLI%20-%20The%20first%20fully%20open-source%2C%20infinitely%20extensible%20scientific%20%22vibe%20analysis%22%20framework.%20An%20AI-driven%20scientific%20intelligent%20agent%20for%20PhD-level%20research%20tasks.%20%23scientific%20%23AI%20%23bioinformatics\u0026url=https%3A%2F%2Fgithub.com%2Faristoteleo%2Fpantheon-cli\n[share-reddit-shield]: https://img.shields.io/badge/-share%20on%20reddit-black?labelColor=black\u0026logo=reddit\u0026logoColor=white\u0026style=flat-square\n[share-telegram-link]: https://t.me/share/url\"?text=Check%20this%20GitHub%20repository%20out%20%F0%9F%A4%AF%20Pantheon%20CLI%20-%20The%20first%20fully%20open-source%2C%20infinitely%20extensible%20scientific%20%22vibe%20analysis%22%20framework.%20An%20AI-driven%20scientific%20intelligent%20agent%20for%20PhD-level%20research%20tasks.%20%23scientific%20%23AI%20%23bioinformatics\u0026url=https%3A%2F%2Fgithub.com%2Faristoteleo%2Fpantheon-cli\n[share-telegram-shield]: https://img.shields.io/badge/-share%20on%20telegram-black?labelColor=black\u0026logo=telegram\u0026logoColor=white\u0026style=flat-square\n[share-weibo-link]: http://service.weibo.com/share/share.php?sharesource=weibo\u0026title=Check%20this%20GitHub%20repository%20out%20%F0%9F%A4%AF%20Pantheon%20CLI%20-%20The%20first%20fully%20open-source%2C%20infinitely%20extensible%20scientific%20%22vibe%20analysis%22%20framework.%20An%20AI-driven%20scientific%20intelligent%20agent%20for%20PhD-level%20research%20tasks.%20%23scientific%20%23AI%20%23bioinformatics\u0026url=https%3A%2F%2Fgithub.com%2Faristoteleo%2Fpantheon-cli\n[share-weibo-shield]: https://img.shields.io/badge/-share%20on%20weibo-black?labelColor=black\u0026logo=sinaweibo\u0026logoColor=white\u0026style=flat-square\n[share-whatsapp-link]: https://api.whatsapp.com/send?text=Check%20this%20GitHub%20repository%20out%20%F0%9F%A4%AF%20Pantheon%20CLI%20-%20The%20first%20fully%20open-source%2C%20infinitely%20extensible%20scientific%20%22vibe%20analysis%22%20framework.%20An%20AI-driven%20scientific%20intelligent%20agent%20for%20PhD-level%20research%20tasks.%20https://github.com/aristoteleo/pantheon-cli%20%23scientific%20%23AI%20%23bioinformatics\n[share-whatsapp-shield]: https://img.shields.io/badge/-share%20on%20whatsapp-black?labelColor=black\u0026logo=whatsapp\u0026logoColor=white\u0026style=flat-square\n[share-x-link]: https://x.com/PantheonOS\n[share-x-shield]: https://img.shields.io/badge/-share%20on%20x-black?labelColor=black\u0026logo=x\u0026logoColor=white\u0026style=flat-square\n\n[pr-welcome-link]: https://github.com/aristoteleo/pantheon-cli/pulls\n[pr-welcome-shield]: https://img.shields.io/badge/👌_pr_welcome-%E2%86%92-ffcb47?labelColor=black\u0026style=for-the-badge\n\n[submit-agents-link]: https://github.com/aristoteleo/pantheon-agents\n[submit-agents-shield]: https://img.shields.io/badge/🤖/🏪_submit_agent-%E2%86%92-c4f042?labelColor=black\u0026style=for-the-badge\n[submit-plugin-link]: https://github.com/aristoteleo/pantheon-toolsets\n[submit-plugin-shield]: https://img.shields.io/badge/🧩/🏪_submit_toolsets-%E2%86%92-95f3d9?labelColor=black\u0026style=for-the-badge\n\n[fossa-license-link]: https://app.fossa.com/projects/git%2Bgithub.com%2FStarlitnightly%2Fpantheon-cli\n[fossa-license-shield]: https://app.fossa.com/api/projects/git%2Bgithub.com%2FStarlitnightly%2Fpantheon-cli.svg?type=large\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faristoteleo%2Fpantheon-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faristoteleo%2Fpantheon-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faristoteleo%2Fpantheon-cli/lists"}