Hajimi 🐱

轻量级 AI 助手框架，为 1核1G VPS 优化。

特性

• 🚀 轻量 - 内存占用 < 200MB
• 🐱 萌系 - 哈基米主题
• 🐳 Docker 部署 - 一键启动
• 💬 Telegram 支持 - Bot 模式
• 🎯 多模型 - MiniMax/Kimi/OpenAI/NVIDIA
• 🎨 Vue 前端 - Web 管理界面
• 📝 灵活配置 - JSON 配置 + Web 编辑
• ❤️ Heartbeat - 定时任务

快速开始

1. 克隆项目

git clone https://github.com/Akanclaw/hajimi.git
cd hajimi

2. 配置

cp config.example.json config.json
# 编辑 config.json 添加 API keys

3. 启动

docker-compose up -d

4. 访问

• Web your-server:808界面: http://0
• Telegram: @your_bot

配置说明

config.json

{
  "name": "Hajimi",
  "system_prompt": "你是 Hajimi，一个友好的 AI 助手...",
  "heartbeat": {
    "enabled": true,
    "interval_minutes": 30,
    "tasks": [
      {
        "name": "健康检查",
        "type": "health"
      }
    ]
  },
  "providers": {
    "default": "minimax",
    "minimax": {
      "api_key": "your-key"
    }
  },
  "telegram": {
    "bot_token": "your-token"
  }
}

目录结构

hajimi/
├── backend/           # Rust 后端
│   └── src/
│       ├── main.rs
│       ├── config.rs    # 配置加载
│       ├── storage.rs   # SQLite 存储
│       ├── provider.rs  # LLM 提供商
│       └── bot.rs       # Telegram Bot
├── frontend/          # Vue 前端
│   └── src/
│       └── views/      # 页面组件
├── data/             # 数据目录 (运行时创建)
│   ├── hajimi.db     # SQLite 数据库
│   ├── config.json   # 配置文件
│   └── memory/       # 记忆文件
├── docker-compose.yml
└── README.md

Web 界面功能

页面	功能
/	会话列表
/settings	配置编辑、API Keys
/onboarding	首次设置向导
/memory	记忆管理

开发

后端

cd backend
cargo run

前端

cd frontend
npm install
npm run dev

部署

VPS 要求

• 1 核 CPU
• 1GB 内存
• 5GB 磁盘
• Docker + Docker Compose

步骤

1. 安装 Docker
2. 克隆项目
3. 配置 config.json
4. 启动服务
5. 访问 Web 界面完成 onboarding

许可证

MIT