# Github Ai

> Local multi-agent workspace with Hermes orchestration, role-based AI agents, memory, scheduling, Skills, MCP, terminal, files, and HTML preview.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ryosukesama-github-ai`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [RyosukeSAMA](https://agentstack.voostack.com/s/ryosukesama)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [RyosukeSAMA](https://github.com/RyosukeSAMA)
- **Source:** https://github.com/RyosukeSAMA/github-ai

## Install

```sh
agentstack add mcp-ryosukesama-github-ai
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Pantheon

> 一个本地多 Agent 工作区：Hermes 负责规划，专业神祇分工执行。

[](CHANGELOG.md)
[](https://www.python.org)
[](https://github.com/RyosukeSAMA/github-ai/actions)
[](LICENSE)
[](#current-boundaries)

[快速开始](#quick-start) · [神祇角色](#agent-roles) · [扩展中心](#integrations) · [架构](#architecture) · [文档](#documentation)

Pantheon 把一个需求变成可观察、可控制的本地协作流程。使用 **Auto** 让 Hermes 自动选择合适的神，切换到 **Multi-role** 发起明确的多角色协作，也可以直接与某位神对话。同一套运行时同时支持 Web UI、CLI 和 Python SDK。

## 当前能力

| 模块 | 当前实现 |
|---|---|
| 多 Agent 调度 | Auto 自动路由、指定角色和强制 Multi-role 计划 |
| Agent 工作区 | 实时 Activity、HTML Preview、文件浏览/编辑和 Terminal |
| 会话 | 多会话、首条消息自动命名、Markdown 导出、附件和 `/` 命令 |
| Memory | 本地 SQLite、角色范围、自然语言记忆识别和保存建议 |
| Chronos | 持久化的单次/周期任务和运行记录 |
| 扩展 | 6 个内置 Skills、本地 Skills、Plugin prompt packs、MCP 工具和 Webhook |
| 本地配置 | Provider/模型向导、配置检查、API 测试和可选登录锁 |

Pantheon 以本地为中心：配置、Memory、定时任务和扩展状态保存在所选工作区，会话和显示偏好保存在当前浏览器。只有在执行任务时，相关内容才会发送给你启用的模型 Provider 或外部集成。

## 快速开始

### 环境要求

- Python 3.10 或更高版本
- Git
- 至少一个支持的模型 Provider，或正在运行的 Ollama
- 推荐 macOS 或 Linux；Windows 用户目前建议使用 WSL

### 安装并启动

```bash
git clone https://github.com/RyosukeSAMA/github-ai.git
cd github-ai

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .

pantheon web
```

打开 ，进入 **Settings → Setup**：

1. 选择 DeepSeek、OpenAI、Anthropic 或 Ollama。
2. 选择模型，并在需要时输入 API key。
3. 依次运行 **Check setup** 和 **Test API**。
4. 点击 **Save local config**。

Web UI 会把 API key 保存到本地 `.env`，把 Provider、Base URL 和模型选择写入 `config/pantheon.yaml`。修改后端配置后，如需完整重载运行时，请重启 `pantheon web`。

手动配置文件

```bash
cp config/pantheon.example.yaml config/pantheon.yaml
cp .env.example .env
```

在 `.env` 中填写所需密钥，并在 `config/pantheon.yaml` 中设置匹配的 Provider、模型和 Base URL。不要提交这两个本地文件。

### 第一次使用

1. 点击 **New Chat**，保持 **Auto** 模式。
2. 输入一个具体任务，例如：`制作一个响应式个人主页，并输出完整 HTML`。
3. 打开 **Workspace** 查看 Hermes 计划、当前 Agent 和执行步骤。
4. 在 **Preview** 预览 HTML，在 **Files** 查看保存的产物，在 **Terminal** 执行本地命令。
5. 在输入框键入 `/`，可以使用 `/multi`、`/schedule`、`/memory`、`/skills`、`/preview` 等命令。

## 神祇角色

Pantheon 用神祇身份表达清晰的职责边界：Hermes 负责编排，Hephaestus 负责构建，Athena 负责研究，Apollo 负责创意，Chronos 负责时间与调度。

  
    
  

Pantheon 品牌概念图。README 顶部的 Web UI 截图展示当前真实产品界面。

### 五神概念海报

  
  
  

  
  

点击海报查看大图。角色图用于表达产品定位；实际模型、联网能力和媒体生成能力取决于用户配置的 Provider、Skills 与 MCP 工具。

下列模型是 `config/pantheon.example.yaml` 中的示例默认值。Hermes、Hephaestus、Athena 和 Apollo 都可以在 Settings 中分别设置不同 Provider 和模型。

| 神祇 | 专长 | 示例模型 | 可执行工具边界 |
|---|---|---|---|
| **Hermes** | 规划、路由、协调和结果汇总 | Claude Opus 4.8 | 调度已配置的 Agent 和获准扩展 |
| **Hephaestus** | 代码生成、调试、重构和审查 | Claude Sonnet 4.6 | 文件或终端改动通过 Workspace 或已授权 MCP 完成 |
| **Athena** | 调研整理、对比、事实核查和摘要 | GPT-5.5 | 实时联网需要已授权的 MCP 或 Provider 工具 |
| **Apollo** | 创意策划、写作、图片提示词和分镜 | GPT-5.4 mini | 真正生成图片、音频或视频需要外部工具 |
| **Chronos** | 单次和周期本地任务 | 无 LLM | 仅在 Pantheon Web 服务运行时执行 |

角色 Prompt 本身不会自动获得外部工具。第三方工具必须先连接，再分配给对应神，并通过 MCP 策略授权后，Pantheon 才会执行。

## Workspace

右侧 Workspace 是任务的操作视图：

- **Activity**：显示当前任务、Hermes 计划、执行中的神、耗时、Skills、Memory 命中、MCP 调用、审批和完成状态。
- **Preview**：在沙箱 iframe 中渲染完整 HTML 和消息产物，支持桌面/移动视图与缩放。
- **Files**：在工作区根目录内浏览、打开、编辑、保存、下载和预览文件。
- **Terminal**：流式显示本地命令输出，保留命令历史，支持取消，并在识别到风险命令时要求确认。

生成的代码默认只是消息 Artifact。只有用户点击 **Save to Files**，或获准工具执行写入后，代码才会变成本地文件。这可以避免普通聊天输出意外修改项目。

## Memory 与定时任务

### Memory

Memory 保存在 `.pantheon/memory.sqlite`，可以设为全局，或只作用于 Hermes、Hephaestus、Athena、Apollo、Chronos 中的某个角色。

- 说“记住……”或使用 `/remember` 可以明确保存记忆。
- Pantheon 可以从普通对话中提出记忆建议，由用户一键确认。
- 可选的自动捕获会保存简短的任务/结果摘要；默认关闭，避免记忆库被噪声污染。
- 使用 `/memories ` 或 **Settings → Memory** 搜索、编辑、置顶和删除记忆。

### Chronos

Chronos 会把支持的自然语言时间表达转换为持久化任务，并保存到 `.pantheon/chronos_jobs.json`。选择 Chronos 或使用 `/schedule`，可以创建、查看、暂停、恢复、立即运行和删除任务。

定时任务会在重启后恢复，但它是本地调度器：Pantheon Web 服务停止期间不会执行任务。

## Integrations 扩展中心

Integrations 提供的是真实本地能力，不是静态展示开关。

| 模块 | 状态 | 当前作用 |
|---|---|---|
| **Skills** | 可用 | 加载标准 `SKILL.md`；支持自动匹配、显式 `/skill` 调用、6 个内置 Skill 和可编辑本地 Skill |
| **MCP** | 可用 | 连接 stdio 或 Streamable HTTP server，发现工具、分配神祇，并设置自动执行/每次审批策略 |
| **Plugins** | 可用 | 把启用的本地 Prompt Pack 注入指定 Agent 上下文；不会执行任意 Python 插件代码 |
| **Channels** | Webhook 可用 | 通过 `/api/channels/webhook` 接收带 Token 的脚本或服务任务 |

### 内置 Skills

- `plan-multi-agent-task`：Hermes 把复杂需求拆成有顺序的多神计划。
- `fix-and-verify`：Hephaestus 定位、修复并验证一个具体缺陷。
- `research-with-sources`：Athena 区分证据与推断，并给出可追踪来源。
- `build-web-preview`：Apollo 与 Hephaestus 设计并实现可预览网页。
- `review-code-change`：Athena 与 Hephaestus 审查代码改动中的具体风险。
- `schedule-and-deliver`：Chronos 把时间要求转换为持久化本地任务。

### MCP 使用流程

1. 打开 **Settings → Integrations → MCP**，添加一个 Server。
2. 点击 **Test connection** 发现工具。
3. 只启用需要的工具，并指定允许使用它们的神。
4. 选择自动执行或每次调用审批。
5. 开启 **Let agents use approved tools**，然后在普通对话中描述任务。

GitHub、Context7 和 Figma Desktop 是连接表单预设，不是 Pantheon 内置账号或托管 MCP 服务。用户仍需提供凭据，并准备对应的本地或远程 Server。

Channels 当前只提供 Webhook 入口。钉钉、企业微信、微信、QQ、Slack、Teams 等原生适配器属于后续计划，目前尚未内置。

## CLI 与 Python SDK

### CLI

```bash
# 让 Hermes 自动决定路由
pantheon ask "调研一个主题并整理可靠证据"

# 直接交给指定神
pantheon ask --role hephaestus "写一个 Python 回文检查器"

# 强制执行有顺序的多 Agent 计划
pantheon ask --multi "调研一个 AI 产品、设计页面并生成 HTML"

# 查看并显式调用 Skill
pantheon skills
pantheon ask --skill fix-and-verify "修复空值处理回归"
```

### Python SDK

```python
from pantheon import Pantheon

pantheon = Pantheon()

result = pantheon.ask("设计并实现一个响应式个人主页", mode="multi")
print(result["content"])

for step in result["steps"]:
    print(step.role, step.duration_ms, step.success)
```

## 本地数据与安全

| 位置 | 保存内容 |
|---|---|
| 浏览器 `localStorage` | 会话历史、显示偏好和部分 UI 状态 |
| `.env` | API key、Webhook Token 和本地登录配置 |
| `config/pantheon.yaml` | Provider、模型、角色、Web 和日志配置 |
| `.pantheon/memory.sqlite` | 长期记忆和记忆建议 |
| `.pantheon/chronos_jobs.json` | Chronos 任务和运行状态 |
| `.pantheon/mcp_servers.json` | MCP Server 与策略；密钥只保存环境变量名引用 |
| `.pantheon/plugins.json` | 本地 Plugin Prompt Packs |
| `.pantheon/skills/` | 本地标准 Skills |

仓库内的这些本地文件均已加入 `.gitignore`，应继续保留在本机。

> [!IMPORTANT]
> Pantheon 包含文件写入和终端执行 API，默认只监听 `127.0.0.1`。使用 `0.0.0.0`、局域网地址、NAS、远程服务器或反向代理前，请先在 **Settings → Security** 开启登录锁，并增加防火墙或代理访问控制。当前登录锁面向单个本地操作者，不是公网多用户鉴权系统。

## 当前边界

Pantheon v0.2.0 仍是 Alpha 阶段的本地工作区，部署前需要了解以下限制：

- Chat Agent 为同步执行；Multi-role 会按计划顺序执行步骤，而不是并行运行。
- 附件会在支持时转换为文本上下文，并不是通用的多模态模型文件上传。
- 语音输入依赖浏览器 SpeechRecognition，不同浏览器和语言的支持程度不同。
- HTML Preview 使用沙箱，但仍应把生成页面视为不可信内容。
- Plugin Pack 是 Prompt 型扩展，不包含任意可执行插件或插件市场。
- Security 登录锁是本地单用户保护，不是生产级身份管理。

## 架构

```text
                    CLI · Web UI · Python SDK
                              │
                       Pantheon 统一入口
                              │
                  Hermes 路由与任务编排
              ┌───────────────┼────────────────┐
              │               │                │
       Skills / Memory   Plugin 上下文    已授权 MCP 工具
              │               │                │
              └───────────────┼────────────────┘
                              │
       Hephaestus · Athena · Apollo · Chronos
                              │
                    已配置的 LLM Provider

Web 运行时：SSE Activity · Workspace · Preview · Files · Terminal
本地状态：.env · pantheon.yaml · .pantheon/ · 浏览器会话
```

运行时负责路由、角色执行、Memory/Skill 上下文注入、MCP 审批与调用、结果汇总和 SSE 进度事件。详细流程见 [docs/architecture.md](docs/architecture.md)。

## 项目结构

```text
pantheon/
├── cli.py                 # Typer CLI
├── core/
│   ├── pantheon.py        # CLI / Web / SDK 共用入口
│   ├── hermes.py          # 编排与流式事件
│   ├── router.py          # Auto 与 Multi-role 计划
│   ├── extensions.py      # Skills、Plugins 与 MCP
│   ├── memory.py          # SQLite Memory
│   └── scheduler.py       # 持久化 Chronos 任务
├── llm/                   # OpenAI-compatible、Anthropic、Ollama 客户端
├── roles/                 # Hermes、Hephaestus、Athena、Apollo、Chronos
├── skills/                # 6 个内置标准 Skills
└── web/
    ├── app.py             # FastAPI、SSE、Setup、Auth 与本地 API
    └── static/            # Web UI 与神祇头像
```

## 测试

普通使用不需要安装开发依赖：

```bash
python -m pip install -e ".[dev]"
ruff check .
pytest
```

GitHub Actions 的 CI 矩阵覆盖 Python 3.10、3.11 和 3.12。

## 文档

| 文档 | 内容 |
|---|---|
| [安装配置](docs/setup.md) | Provider 配置与常见问题排查 |
| [Web UI 指南](docs/web-ui.md) | Workspace、Memory、Integrations、测试和快捷键 |
| [架构说明](docs/architecture.md) | 路由、执行流程与组件设计 |
| [角色说明](docs/roles/) | 各神祇 Prompt 与职责 |
| [FAQ](docs/faq.md) | 常见配置和行为问题 |
| [Changelog](CHANGELOG.md) | 版本更新记录 |
| [贡献指南](CONTRIBUTING.md) | 开发与贡献流程 |

## Roadmap

- [x] **v0.1**：5 个角色、Hermes 调度、CLI、Web UI 和 SDK
- [x] **v0.2**：多会话工作区、实时 Activity、Chronos、Memory、Skills、MCP、Webhook 和本地登录锁
- [ ] **v0.3**：原生频道适配器、MCP resources/prompts 和可视化任务编排
- [ ] **v0.4**：可安装扩展目录、语义记忆检索和可观测性
- [ ] **v1.0**：多用户身份、审计日志、限流和分布式执行

## 贡献

欢迎贡献角色、Skills、Integrations、测试、文档和无障碍改进。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

## License

MIT © 2024–2026 RyosukeSAMA

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [RyosukeSAMA](https://github.com/RyosukeSAMA)
- **Source:** [RyosukeSAMA/github-ai](https://github.com/RyosukeSAMA/github-ai)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ryosukesama-github-ai
- Seller: https://agentstack.voostack.com/s/ryosukesama
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.