{"repo":"usepr/eva","free":true,"listed":false,"github":"https://github.com/usepr/eva","clone":"git clone https://github.com/usepr/eva.git","description":"单文件智能体","language":"Python","stars":384,"topics":["automation","shell","agent","ai","cli","python","local-ai","single-file","ai-agent"],"license":"MIT","category":"cli-tools","readme_excerpt":"如果一个智能体的执行层小到只是一个脚本，那它具有病毒传播一样的潜力。 EVA 是一个极致轻量、可接本地模型、带安全审查与目录级 Session 的单文件 Agent。 Quick Start · Showcase · WeChat Bot · EVA.md 简介 EVA是个麻雀虽小、五脏俱全的Agent智能体，相当于低配版Claude Code，能帮你写脚本、写测试案例、执行shell、分析数据等。我自己就是EVA的重度用户，日常使用频率非常高。 各种好玩案例见当前仓库的 showcase 🦖🦖🦖 特性 - 本地化：可以接入本地部署的OpenAI接口模型，如vLLM，或者是外网模型 - 极致轻量化：单文件，仅一个 eva.py ，有python就能运行 - 目录级Session：下次同样目录启动会延续之前对话 - 安全审查：默认只执行读命令，其他命令需要安全确认 - 移植性：很容易将EVA接入你现有的自动化流程，例如： eva -au '计算100w以内所有素数和并写到/tmp/result.txt' 。当前就借助 -asu 选项将EVA接入了微信Bot 快速开始 0. 直接创建一个eva.py并复制本仓库的eva.py文本内容粘贴进去（docker环境、运维环境等也很容易粘贴代码，无需复杂安装，Just Paste and Go ）。当然，你也可以git clone本仓库 1. 在终端执行 export EVA API KEY=你的deepseek API key （Windows系统则是 set 命令） EVA支持OpenAI接口形式的LLM，可以是Ollma、vLLM拉起的本地模型，也可以是DeepSeek、OpenAI等官网API。切换方法是设置 EVA BASE URL , EVA MODEL NAME , EVA API KEY 这三个环境变量。 Linux设置方法： macOS 设置方法（zsh，如需在 macOS 上长期生效，可以将上述 export 配置写入 /.zshrc 。）： Windows 命令行设置方法： Windows PowerShell设置方法： 2. 运行 python3 eva.py 。首次运行会生成 eva 脚本，Linux 下执行 source /.bashrc 让脚本生效；macOS 下执行 source /.zshrc 让脚本生效。后续直接输入命令 eva 即可 输入增强说明： - 如果环境里安装了 prompt toolkit ，EVA会自动开启多行输入： Enter 提交， Ctrl+N 换行；如果终端支持，也可以用 Alt+Enter 换行 输出增强说明： - 如果环境里安装了 rich ，EVA会自动开启rich美化输出 绝大部分同学都带上-a来启动eva，虽然很方便，但要对eva行为多加关注下。 EVA退出说明（按Ctrl + C） 1、EVA运行过程可以随时打断，无论是打断LLM推理、打断工具执行、还是退出EVA，都是按 Ctrl + C 2、打断是个很有用的行为，比如某个命令超时时间太久你不想再等待，或者你想起有个背景忘记向EVA澄清需要补充说明，或者你发现前面对话有错别字想做修正说明 —— 注意，无论何时你都可以 Ctrl + C 打断EVA，无论何时 🎯🎯 关于 EVA.md .eva/EVA.md 是EVA的设定，通过它你可以对EVA进行各种设定、甚至赋予它各种技能。除了手动编辑 EVA.md ，你可以在eva启动时让它“分析下xxx/xxx/skills目录中的可用技能","default_branch":null,"files":null,"tree":[],"storefront":"/r/usepr","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/usepr/eva/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}