NeoFish 🐟

人人可用的 Agent，你的终极数字奴隶

---

🌟 什么是 NeoFish？

NeoFish 是一款旨在让人人都能轻松使用的全能 AI Agent 原型系统。它不仅是一个可以聊天的助手，更是一个能够真正操控浏览器、接管繁琐工作的数字劳动力。无需复杂的编程知识，只要用自然语言下达指令，NeoFish 就能像你最忠诚的“数字奴隶”一样，不知疲倦地在网页中为你点击、输入、提取信息、完成任务。

✨ 核心特性

• 🤖 全能浏览器交互: 深度集成 Playwright 引擎，支持页面导航、元素点击、键盘输入、滚动和截图分析。
• ⚡️ 极速实时流式响应: 基于 FastAPI 和 WebSocket 架构，实现后台 Agent 思考过程与前端 UI 的毫秒级状态同步。
• 🎨 现代化丝滑前端 UI: 采用 Vue 3 + Tailwind CSS 打造的极简质感界面，内置流畅的对话滚动与状态指示。
• 🌍 原生多语言支持: 完整的中英文 (i18n) 支持，侧边栏一键顺滑切换。
• 🧠 智能停顿与人工介入: 当 Agent 遇到阻碍（如遇到验证码、需要扫码登录时），会自动暂停并截取当前画面发送给用户，等待人类确认后继续执行。
• 🛠️ 极简配置接入: 通过标准 .env 配置，轻松接入任何支持工具调用 (Tool Use) 的大模型 API（默认兼容 Anthropic/OpenAI 接口规范）。

🏗️ 架构概览

NeoFish 采用轻量级的前后端分离架构设计：

• 服务端 (Backend): Python (FastAPI + Playwright)
  • 负责维护浏览器进程上下文。
  • 通过 WebSocket 接受前端指令。
  • 运行 Agent 核心逻辑：思考(Think) -> 调用工具(Action) -> 观察反馈(Observation)。
• 客户端 (Frontend): Web (Vue 3 + Vite + TailwindCSS)
  • 负责与用户的交互可视化。
  • 实时渲染 Agent 的执行动作、日志和错误提示。
  • 内置完整的国际化语言包。

🚀 快速开始

1. 环境准备

确保你已安装强大的 Python 依赖管理工具 uv 以及 Node.js。

2. 克隆项目

git clone https://github.com/LangQi99/NeoFish.git
cd NeoFish

3. 配置环境变量

在根目录创建或修改 .env 文件：

ANTHROPIC_API_KEY=your_api_key_here
ANTHROPIC_BASE_URL=https://api.your-proxy.com
# 推荐使用具备强大推理与 Tool Call 能力的模型
MODEL_NAME=claude-3-7-sonnet-20250219 

4. 启动后端 (Agent 服务)

后端将自动安装所需依赖并启动网页交互引擎（首次运行可能会下载浏览器内核）：

uv run uvicorn main:app --reload

服务将运行在 http://127.0.0.1:8000

5. 启动前端 (UI 界面)

打开一个新的终端窗口：

cd frontend
npm install
npm run dev

打开浏览器访问 http://localhost:5173 即可开始体验！

💡 使用场景示例

你可以对 NeoFish 说出以下指令：

• "帮我打开掘金，搜索 'Vue3 性能优化'，并把前三篇文章的标题和链接总结给我。"

• "进入 Github，查看趋势榜单，截个图发给我。"

• "总结oiwiki的kmp内容然后发到小红书上"

  

• "帮我填写一份调查问卷..."

  

• "根据我的b站视频浏览记录分析我的喜好/作息/行为特点"

🤝 参与贡献

NeoFish 欢迎任何形式的贡献！无论你是想修复 Bug、添加新功能，还是改进文档，都非常欢迎提交 Pull Request。

⭐ Star History

---

_{Built with ❤️ by LangQi99 & the Open Source Community.}