Mill

Mill 是一个面向餐饮副业者的本地优先、自主 AI 助手，核心能力围绕库存审计、订单管理、备餐引导与 AI 对话展开。

Mill 后端基于 FastAPI 与 SQLAlchemy 2.0 操作 SQLite，通过 Server-Sent Events 实现 AI token 的实时流式输出。

Mill 前端使用 React 19、TypeScript、Tailwind CSS，配合 @dnd-kit 实现可访问的物理感看板拖拽，React Query 管理数据请求，支持深浅色主题。

Mill 的工具协议层是 FastMCP，暴露 16 个类型化工具，挂载在 http://127.0.0.1:8000/mcp。

Mill 的 AI 代理引擎基于 openai-agents，连接 OpenAI 兼容端点；把 OPENAI_BASE_URL 指向 http://localhost:11434/v1 就能通过 Ollama 运行开源权重模型（如 gemma、llama3.2、qwen2.5），完全本地化，零代码改动。

Mill 通过本地 Ollama 运行开源权重模型，持续 API 费用为零，而按 token 计费的云端 API 会在每次询问配方定价或查库存时侵蚀利润。

Mill 项目申报了 Hacktoberfest 第二周主赛道与“最佳 Gemma 使用”奖项。

Mill 提供两步启动流程：后端通过 uv run mill-seed 播种真实的库存、配方和示例订单，uv run mill-api 启动 API 服务；前端用 bun install 与 bun dev 拉起看板，之后可在 http://localhost:5173 操作。

Mill 的可视化看板履约流水线在 Upcoming、Preparing、Completed 三列之间拖拽管理订单，把订单卡片拖到 Completed 列时系统自动计算所需配方原料并从库存中扣减，同时写入审计台账。