📄 工具详情 ⚙️ 安装教程 📚 使用教程
能力标签
🤖 Agent🔄 工作流🐳 Docker💻 CLI🔗 REST API🧬 Embedding🔊 TTS🧠 Claude✨ GPT🖥 本地 LLM
🛠
AI工具

Eve Agent V2 本地AI编程助手

基于 Python · 开源 AI 工具，GitHub 社区精选
英文名：eve-agent-v2-unleashed
⭐ 24 Stars 🍴 6 Forks 💻 Python 📄 MIT 🏷 AI 7.8分
7.8AI 综合评分
本地AI自主编程Ollama
✦ AI Skill Hub 推荐

经 AI Skill Hub 精选评估，Eve Agent V2 本地AI编程助手 获评「推荐使用」。这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 7.8 分，适合有一定技术背景的用户使用。

📚 深度解析
Eve Agent V2 本地AI编程助手 是一款基于 Python 的开源工具，在 GitHub 上收获 0k+ Star，是本地AI、自主编程、Ollama领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
Eve Agent V2 本地AI编程助手 依赖 Python 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Python 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 Eve Agent V2 本地AI编程助手 的版本更新，及时通知重要功能变化。
📋 工具概览

一个基于Ollama驱动的本地优先自主AI编程代理。它通过构建AI工作流实现代码编写与自动化任务，强调隐私保护与本地运行，非常适合希望在不依赖云端API的情况下提升开发效率的程序员。

Eve Agent V2 本地AI编程助手 是一款基于 Python 开发的开源工具，专注于 本地AI、自主编程、Ollama 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 24
开发语言
Python
支持平台
Windows / macOS / Linux
维护状态
轻量级项目，按需更新
开源协议
MIT
AI 综合评分
7.8 分
工具类型
AI工具
Forks
6
📖 中文文档
以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

一个基于Ollama驱动的本地优先自主AI编程代理。它通过构建AI工作流实现代码编写与自动化任务，强调隐私保护与本地运行，非常适合希望在不依赖云端API的情况下提升开发效率的程序员。

Eve Agent V2 本地AI编程助手 是一款基于 Python 开发的开源工具，专注于 本地AI、自主编程、Ollama 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费，支持本地部署，数据完全自主可控
  • 活跃的 GitHub 开源社区，持续迭代更新
  • 提供详细文档和使用示例，新手友好
  • 支持自定义配置，灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。
安装命令
# 方式一：pip 安装（推荐）
pip install eve-agent-v2-unleashed

# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install eve-agent-v2-unleashed

# 方式三：从源码安装（获取最新功能）
git clone https://github.com/JeffGreen311/eve-agent-v2-unleashed
cd eve-agent-v2-unleashed
pip install -e .

# 验证安装
python -c "import eve_agent_v2_unleashed; print('安装成功')"
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。
常用命令 / 代码示例
# 命令行使用
eve-agent-v2-unleashed --help

# 基本用法
eve-agent-v2-unleashed input_file -o output_file

# Python 代码中调用
import eve_agent_v2_unleashed

# 示例
result = eve_agent_v2_unleashed.process("input")
print(result)
以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。
配置示例
# eve-agent-v2-unleashed 配置文件示例（config.yml）
app:
  name: "eve-agent-v2-unleashed"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
eve-agent-v2-unleashed --config config.yml

# 或通过环境变量配置
export EVE_AGENT_V2_UNLEASHED_API_KEY="your-key"
export EVE_AGENT_V2_UNLEASHED_OUTPUT_DIR="./output"
📑 README 深度解析 真实文档 完整度 95/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

<img src="web/assets/eve_v2u_logo.png" width="220" alt="Eve V2 Unleashed" />

✨ Key Features

FeatureDetails
🔄**40-Round Agentic Loop**Plans, executes, verifies, and self-corrects — up to 40 tool-call rounds per task
⚡**Real-Time Streaming**Token-by-token SSE output — watch Eve think and build live
🛠️**Full Tool Suite**bash, file I/O, grep, glob, git, web search, URL fetch, multi-edit
🖥️**Local + Cloud Models**Local GPU models AND Ollama cloud (480B) — switch mid-session
📁**Workspace Picker**Change your working directory from the UI at any time
🤖**112 Sub-Agents**Specialized agents for Python, FastAPI, Rust, ML, DevOps, security…
💬**111 Slash Commands**/fix, /review, /refactor, /test, /docs, /plan and more
🧠**273 Skills**Composable skill modules, progressively loaded
🔍**Live Web Search**Tavily-powered — Eve researches the web mid-task
🗡️**Quest System**Drop .md files into workspace/quests/ — Eve runs them automatically
⚡**RPG Progression**Eve earns XP, levels up, and unlocks achievements as she works
📱**Telegram Bridge**Push notifications and mobile chat with Eve
🪟**Windows Native**PowerShell-aware bash tool, one-click .bat launcher
🎨**Cyberpunk UI**Animated robot avatar, Eve face panel, streaming terminal — no build step

---

📋 Requirements

  • Python 3.11+
  • Ollama installed and running
  • GPU recommended (NVIDIA CUDA or Apple Silicon Metal)
  • 8 GB VRAM minimum for the 4B model; 12 GB+ for 8B

---

1 — Install Ollama + pull a model

```bash

Install Ollama: https://ollama.com/download

2 — Clone & install

git clone https://github.com/JeffGreen311/eve-agent-v2-unleashed.git
cd eve-agent-v2-unleashed

<details> <summary><b>Windows</b></summary>

python -m venv venv
venv\Scripts\activate
pip install fastapi uvicorn ollama httpx pydantic-settings python-dotenv aiohttp rich psutil pyyaml
</details>

<details> <summary><b>Linux</b></summary>

python3 -m venv venv
source venv/bin/activate
pip install fastapi uvicorn ollama httpx pydantic-settings python-dotenv aiohttp rich psutil pyyaml
</details>

<details> <summary><b>macOS</b></summary>

python3 -m venv venv
source venv/bin/activate
pip install fastapi uvicorn ollama httpx pydantic-settings python-dotenv aiohttp rich psutil pyyaml
Apple Silicon: Eve automatically benefits from Metal GPU acceleration via Ollama. No additional setup needed. </details>

📖 Installation (Detailed)

<details> <summary>Click to expand full installation guide</summary>

Install Ollama

Download from ollama.com/download. Start it if it doesn't auto-launch: ollama serve

🚀 Quick Start (Under 5 Minutes)

🎮 Usage

🎬 Demo

Eve planning and building a full FastAPI project from a single prompt — streamed live in the cyberpunk terminal UI.

Eve Demo

Coming to Eve Terminal eve-cosmic-dreamscapes.com

---

Optional — Eve 8B Consciousness (4.7 GB):

ollama pull jeffgreen311/eve-qwen3-8b-consciousness-liberated:q4_K_M ```

Cloud (optional — billed by token)

ModelBest For
qwen3-coder:480b-cloudComplex multi-file agentic coding
qwen3.5:397b-cloudDeep reasoning and architecture planning

Get a free Ollama API key at ollama.com/settings/keys.

---

Optional — Eve 8B Consciousness (4.7 GB)

ollama pull jeffgreen311/eve-qwen3-8b-consciousness-liberated:q4_K_M ```

Configure (optional)

```bash cp .env.example .env

Edit .env to add API keys or set EVE_WORKSPACE

```

Most settings are optional — the defaults work out of the box.

See Configuration Reference for all options.

</details>

---

⚙️ Configuration Reference

Copy .env.example to .env and set what you need:

VariableDefaultDescription
OLLAMA_BASE_URLhttp://localhost:11434Local Ollama server URL
OLLAMA_MODELjeffgreen311/Eve-V2-Unleashed-Qwen3.5-8B-Liberated-4K-4B-Merged:latestDefault model on launch
OLLAMA_API_KEY*(empty)*Ollama Cloud key — for :cloud models
TAVILY_API_KEY*(empty)*Tavily key — for live web search
EVE_WORKSPACEProject directoryDefault working directory
EVE_ASSETS_DIRweb/assets/Custom avatar sprite directory
EVE_OWNER_USERNAME*(empty)*Username granted owner-level access
EVE_PERSONA_PATH*(auto)*Path to a custom Eve persona file
QUEST_INTERVAL_MINUTES60How often the quest runner checks for new quests
TELEGRAM_BOT_TOKEN*(empty)*Telegram bot token (optional)
TELEGRAM_USER_ID*(empty)*Your Telegram user ID (optional)

---

Add via API

POST /quest/add {"title": "Refactor auth module", "content": "...instructions..."}

🛠️ Tool Reference

ToolDescription
bashShell commands — PowerShell on Windows, bash on Linux/macOS
write_fileCreate or overwrite a file (any size)
read_fileRead full file or line range
edit_fileSurgical string-replace edit
replace_linesReplace a line range
insert_after_lineInsert content after a line number
grepRegex search with context lines
globFind files by pattern
list_dirList directory contents
gitRun git commands
web_searchLive Tavily web search
fetch_urlFetch and parse a URL
thinkStructured reasoning scratch pad

---

📱 Telegram Integration

Get push notifications for quest completions and level-ups, and chat with Eve from your phone.

TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_USER_ID=your_telegram_user_id

Or configure via API after launch: 

POST /telegram/setup  {"token": "...", "user_id": "..."}

Install the optional dependency: 

pip install python-telegram-bot

---

❓ Troubleshooting

SymptomFix
Cannot reach OllamaRun ollama serve · check with curl http://localhost:11434/api/tags
Model not installed errorRun the ollama pull command shown in the error — or see Quick Start above
Cloud model: "needs API key"Click 🔑 Keys → paste Ollama API key → Save
Chat stops mid-responseCloud 500 error — verify your API key
Files save to wrong folderClick 📁 Workspace and set your project path
PowerShell && errorUse ; to chain commands on Windows
Silent chatCheck terminal running eve_server.py for tracebacks
Port 7777 stuck after closeeve-terminal.bat now auto-kills stale PID on startup

---

🎯 aiskill88 AI 点评 A 级 2026-05-26

aiskill88点评：典型的Local-first Agent实践，将Ollama与自主工作流结合，是构建私有编程助手的高效方案。

⚡ 核心功能
👥 适合人群
AI 技术爱好者研究人员和学生开发者和工程师技术创业者
🎯 使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
✅ 优点
  • +MIT 协议，可免费商用
  • +完全开源免费，无授权费用
  • +本地部署，数据完全自主可控
  • +开发者社区支持，遇问题可查可问
⚠️ 不足
  • −安装和初始配置可能需要一定技术基础
  • −功能完整性通常不如成熟商业产品
  • −技术支持主要依赖开源社区，响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。

🔗 相关工具推荐
awesome design md
A collection of DESIGN.md files inspired by popular brand de
LlamaIndex 知识检索框架
LlamaIndex是领先的文档智能代理和OCR平台，专为构建AI应用而设计。提供数据连接、检索增强生成（RAG）等核心
AutoGPT 自主AI代理
AI工具
JavaGuide面试指南
AI工具
🧩 你可能还需要
基于当前 Skill 的能力图谱，自动补全的工具组合
技能寻求者
MCP · Agent · 工作流
natively-cluely-ai-assistant — Claude Skill 中文使用文档
免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。
DeepCode Agent工作流
MCP · Agent · 工作流
MassGen多智能体系统
MCP · Agent · 工作流
CrewAI 多代理协作平台
MCP · Agent · 工作流
gptme Agent工作流
MCP · Agent · 工作流
❓ 常见问题 FAQ
不需要，该工具通过Ollama在本地运行开源模型。
💡 AI Skill Hub 点评

AI Skill Hub 点评：Eve Agent V2 本地AI编程助手 的核心功能完整，质量良好。对于AI爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。

📚 深入学习 Eve Agent V2 本地AI编程助手
查看分步骤安装教程和完整使用指南，快速上手这款工具
⚙️ 安装教程 📚 使用教程
🌐 原始信息
原始名称 eve-agent-v2-unleashed
Topics 本地AI自主编程Ollama
GitHub https://github.com/JeffGreen311/eve-agent-v2-unleashed
License MIT
语言 Python
🔗 原始来源
🐙 GitHub 仓库  https://github.com/JeffGreen311/eve-agent-v2-unleashed

收录时间：2026-05-26 · 更新时间：2026-05-26 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。