MiniAgent 🤖

一个轻量级的 AI Agent，支持 CLI 交互和工具调用。

功能特性

• 🖥️ CLI 交互模式 - 交互式命令行对话
• 🔧 工具调用 - 支持文件系统操作、视频处理、Bash 命令等
• 💾 会话持久化 - 自动保存对话历史
• ⚙️ 灵活配置 - 支持 Ollama 和 OpenAI 兼容 API

支持工具

工具	说明
list_dir	列出目录内容
read_file	读取文件
write_file	写入文件
edit_file	编辑文件
create_dir	创建目录
bash	执行 Bash 命令（需确认）
video_clip	视频裁剪
video_transcribe	视频语音转文字

安装

cd MiniAgent
pip install -r requirements.txt

快速开始

交互模式

python -m src.main

命令行选项

# 创建新会话
python -m src.main --new

# 列出所有会话
python -m src.main --list

# 切换到指定会话
python -m src.main --session <session_id>

# 删除会话
python -m src.main --delete <session_id>

# 清除当前会话记录
python -m src.main --clear

配置

配置文件位于 ~/.miniagent/.env

# OpenAI 兼容 API
API_KEY=your_api_key
API_URL=https://api.openai.com/v1
MODEL=gpt-4

# 或使用 Ollama
OLLAMA_MODEL=qwen3:8b

会话管理

• 会话保存在 ~/.miniagent/sessions/
• 每个会话存储对话历史、工作目录等信息
• 重启后自动恢复最近会话

交互命令

在交互模式中可用：

• exit / quit - 退出
• clear - 清除对话历史
• pwd - 显示当前工作目录

路线图

┌─────────────────────────────────────┐
│           MiniAgent                  │
├─────────────────────────────────────┤
│  ✅ CLI Mode                        │
│  ✅ Session Management              │
│  ✅ Tool System                     │
│                                     │
│  🚧 FastAPI Server (Coming Soon)    │
│     - REST API                      │
│     - WebSocket Streaming           │
│     - Multi-agent Support           │
└─────────────────────────────────────┘

项目结构

MiniAgent/
├── src/
│   ├── client/       # LLM 客户端 (Ollama/OpenAI)
│   ├── core/         # 核心逻辑 (AgentLoop, SessionManager)
│   ├── prompts/      # 系统提示词
│   ├── tools/        # 工具实现
│   └── main.py       # CLI 入口
└── .env              # 配置文件