# miniagent **Repository Path**: juno20252026/miniagent ## Basic Information - **Project Name**: miniagent - **Description**: 一个会自己写代码、自己进化的桌面AI Agent - **Primary Language**: Python - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-07-26 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: ai **Tags**: 智能体, 桌面应用, Python, AI助手, 自动化工具 ## README # MiniAgent **开发语言:Python 3.8+** > 一个会自己写代码、自己进化的桌面 AI Agent。 中文原生支持,无需看懂英文,打开就能用。 --- ## ✨ 它和普通 AI 助手有什么不同? | 特性 | MiniAgent | 普通 AI 助手 | |------|-----------|--------------| | 🤖 **双模型协作** | 主 AI 负责思考决策和调用脚本及协作AI,协作 AI 负责记忆 | 单一模型,所有工作自己扛 | | 🔧 **自己写扩展** | AI 可以自己生成扩展代码并调用,能力自我进化 | 功能固定,无法自行扩展 | | 💓 **心跳机制** | 空闲时自主行动,可以学习、整理记忆、执行定时任务 | 只能被动响应用户输入 | | 👀 **双屏透明化** | 左边看对话结果,右边看 AI 的思考过程 | 黑盒运行,看不到中间过程 | | 📋 **任务管理** | 支持定时任务、循环任务、代码任务,无人值守自动执行 | 无任务调度能力 | **一句话总结:你给它一个目标,它自己想办法搞定。** --- ## 🚀 快速上手 ### 1. 下载源码 **GitHub(国际):** ```bash git clone https://github.com/juno20252026/miniagent.git cd miniagent ``` **Gitee(国内镜像,速度更快):** ```bash git clone https://gitee.com/juno20252026/miniagent.git cd miniagent ``` > 任选一个地址克隆即可,内容完全相同。 ### 2. 安装依赖 **基础依赖(必须安装):** ```bash pip install -r requirements.txt ``` **如果安装速度慢,可使用国内镜像:** ```bash pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ ``` **依赖清单:** | 依赖包 | 用途 | |--------|------| | `requests` | AI 客户端 API 调用 | | `numpy` | 向量计算(语义检索) | | `sentence-transformers` | 语义检索模型(向量嵌入) | | `jieba` | 中文分词 | | `psutil` | 看门狗进程监控(暂未使用) | | `tkinter` | 桌面 GUI 界面(Python 内置,无需额外安装) | | `sqlite3` | 本地数据库(Python 内置,无需额外安装) | > 以上依赖已在 `requirements.txt` 中列明,执行上述命令会自动全部安装。 ### 3. 启动 ```bash python miniagent.py ``` 首次启动会自动弹出配置窗口,选择 AI 后端,填好 API Key 即可。 --- ## 🧠 支持的 AI 后端 | 后端 | 说明 | API Key | |------|------|---------| | **Ollama** | 本地运行,免费 | 无需 | | **通义千问** | 阿里云 DashScope | 需要 | | **DeepSeek** | 国内 API,性价比高 | 需要 | | **智谱 GLM** | 免费模型 `glm-4.5-flash` | 需要 | | **TokenHub** | 支持任意 OpenAI 兼容接口 | 需要 | --- ## 📁 项目结构 ``` miniagent/ ├── miniagent.py # 主入口 ├── ai_client.py # AI 客户端(多模型支持) ├── config_manager.py # 配置管理(首次启动自动弹窗) ├── extension_manager.py # 扩展系统(AI 自己写扩展) ├── mission_manager.py # 任务管理 ├── knowledge_base.py # 知识库管理 ├── semantic_retriever.py # 语义检索 ├── prompts.py # 系统提示词 ├── json_parser.py # JSON 解析器 ├── simple_logger.py # 日志模块 ├── watchdog.py # 看门狗 ├── requirements.txt # 依赖清单 └── README.md # 本文件 ``` --- ## 🎯 使用场景 - **个人助理**:定时提醒、每日报告、信息采集 - **知识管理**:构建个人知识库,语义检索 - **自动化运维**:定时执行脚本,无人值守 - **学习伴侣**:与 AI 协作学习新知识 --- ## 🤝 贡献 欢迎提交 Issue 和 Pull Request! 如果你有好的想法或发现 Bug,请随时提出。 --- ## 📄 许可证 **MIT License** © 2026 马军 随意使用、修改、分发。 --- ## ⭐ 支持 如果这个项目对你有帮助,点个 Star 就是对我最大的鼓励! --- **Made with love by a developer who believes AI should be able to grow itself.**