mini-coding-agent

环境要求

• 已安装 Ollama，且 shell 中可用 ollama 命令
• 本机可运行 ollama serve 启动本地模型服务
• 已拉取模型（默认 qwen3.5:4b）
• Python 环境（可选 uv 用于运行 CLI）

安装与启动步骤

1. 1安装 Ollama

   按官方下载页安装 Ollama，装完后 ollama 命令应能在终端中直接调用，无安装命令由 README 提供。

2. 2验证 Ollama

   确认 ollama 命令已可用，会打印帮助信息说明安装成功。

   ollama --help

   复制

3. 3启动模型服务

   在一个终端启动本地服务并保持运行，后续智能体都通过它调用模型。

   ollama serve

   复制

4. 4拉取默认模型

   另开一个终端拉取默认模型 qwen3.5:4b，内存充足可换 qwen3.5:9b 等更大版本。

   ollama pull qwen3.5:4b

   复制

5. 5克隆并进入仓库

   克隆官方仓库后进入目录；若使用自己的 fork，把 URL 换成你的分支地址。

   git clone https://github.com/rasbt/mini-coding-agent.git
   cd mini-coding-agent

   复制

6. 6启动智能体

   用 uv 运行 CLI；没有 uv 时可直接执行 python mini_coding_agent.py，默认模型 qwen3.5:4b、approval 为 ask。

   uv run mini-coding-agent

   复制

7. 7不使用 uv 启动

   若未安装 uv，可在仓库目录直接运行脚本启动同一个智能体。

   python mini_coding_agent.py

   复制

关键配置

如何确认成功

启动命令执行后终端进入智能体交互循环；若报模型不可用，检查 ollama serve 是否运行、模型是否已 pull。

常见问题

注意事项

• 默认模型为 qwen3.5:4b，内存充足时可用 qwen3.5:9b 或更大的 Qwen 3.5 变体
• 默认 approval 为 ask，调用风险工具时会先请求确认
• 智能体把提示发送到 Ollama 的 /api/generate 接口
• 具体使用示例见仓库中的 EXAMPLE.md