Metadata-Version: 2.4
Name: gugaclaw
Version: 1.0.7
Summary: 多模型 AI 助手，具备 Agent 能力、可扩展技能系统与 MCP 工具集成
Project-URL: Homepage, https://github.com/IceSniperring/gugaclaw
Project-URL: Documentation, https://github.com/IceSniperring/gugaclaw#readme
Project-URL: Repository, https://github.com/IceSniperring/gugaclaw
Project-URL: Issues, https://github.com/IceSniperring/gugaclaw/issues
Author: GugaClaw Team
License: MIT
Keywords: agent,ai,anthropic,chatbot,langchain,llm,mcp,openai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: aiomysql>=0.2.0
Requires-Dist: anthropic>=0.39.0
Requires-Dist: anyio>=4.7.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: ddgs>=9.0.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: greenlet>=3.0.0
Requires-Dist: httpx[socks]>=0.27.0
Requires-Dist: langchain-anthropic>=0.3.15
Requires-Dist: langchain-community>=0.3.31
Requires-Dist: langchain-core>=0.3.83
Requires-Dist: langchain-openai>=0.3.35
Requires-Dist: langchain>=0.3.28
Requires-Dist: loguru>=0.7.2
Requires-Dist: openai>=1.104.2
Requires-Dist: psutil>=5.9.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.7.4
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: redis>=5.0.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: sse-starlette>=3.3.3
Requires-Dist: starlette>=0.49.1
Requires-Dist: tiktoken>=0.5.0
Requires-Dist: uvicorn[standard]>=0.30.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.3.0; extra == 'dev'
Requires-Dist: twine>=5.0.0; extra == 'dev'
Provides-Extra: rich
Requires-Dist: rich>=13.0.0; extra == 'rich'
Description-Content-Type: text/markdown

# GugaClaw

> 多模型 AI 助手，具备 Agent 能力、可扩展技能系统与 MCP 工具集成。

![主界面](docs/screenshot-main.png)

---

## 安装

### PyPI 安装（推荐）

```bash
pip install gugaclaw
gugaclaw start
```

### 从 GitHub 安装

```bash
pip install git+https://github.com/IceSniperring/gugaclaw.git
gugaclaw start
```

### 从源码运行

**macOS / Linux:**
```bash
git clone https://github.com/IceSniperring/gugaclaw.git
cd gugaclaw
pip install -e .
gugaclaw start
```

**Windows (PowerShell):**
```powershell
git clone https://github.com/IceSniperring/gugaclaw.git
cd gugaclaw
pip install -e .
gugaclaw start
```

---

## 前置要求

- Python 3.11+
- Node.js 18+（前端运行需要）

### Windows 用户注意

如果 PowerShell 执行脚本报错，请先运行：
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

---

## 命令行用法

```bash
gugaclaw start        # 后台启动服务
gugaclaw stop         # 停止服务
gugaclaw restart      # 重启服务
gugaclaw status       # 查看状态
gugaclaw logs -f      # 实时日志
gugaclaw dev          # 前台开发模式
gugaclaw config       # 管理配置
gugaclaw tools        # 列出工具
gugaclaw --help       # 查看帮助
```

---

## 功能一览

| 功能 | 说明 |
|---|---|
| **多提供商支持** | OpenAI、Anthropic、MiMo、DeepSeek、Moonshot 等 |
| **三种输入模式** | Chat · Agent · 命令 |
| **Agent 模式** | 文件操作、终端、搜索等 14 个内置工具 |
| **Skill 系统** | AI 可创建/编辑/热重载技能 |
| **MCP 集成** | 支持 stdio / SSE / Streamable HTTP |
| **危险命令审批** | 危险命令拦截，支持三级永久允许 |
| **智能上下文** | 基于 Token 管理，优先级保留，摘要压缩 |

---

## 配置

配置目录: `~/.gugaclaw/`

| 文件 | 说明 |
|---|---|
| `providers.json` | API 提供商配置 |
| `db_config.json` | 数据库配置（可选） |
| `allowed_commands.json` | 永久允许的命令 |
| `skills/` | 用户技能目录 |

---

## 项目结构

```
gugaclaw/
├── gugaclaw/         # CLI 入口
├── server/           # FastAPI 后端
├── client/           # Next.js 前端
├── pyproject.toml    # PyPI 配置
└── README.md
```

---

## 技术栈

**后端：** Python 3.11 · FastAPI · LangChain · SQLAlchemy · Redis

**前端：** Next.js · React · TypeScript · Tailwind CSS

---

## License

MIT
