Content
<div align="center">
<img src="README_logo.png" width="300"><br><br>
<b><font size="4">Load your AI agent like Minecraft mods</font></b><br><br>
<p>
<img src="https://img.shields.io/badge/Python-3.7+-3776AB?logo=python&logoColor=white">
<img src="https://img.shields.io/badge/Platform-Windows-0078D4?logo=windows&logoColor=white">
<img src="https://img.shields.io/badge/Size-316_MB-165DFF">
<img src="https://img.shields.io/badge/License-Apache_2.0-blue">
<img src="https://img.shields.io/badge/DeepSeek-Supported-4D6BFE">
</p>
</div>
---
## Tool List
## ✨ Features
1. 🚀 **DeepSeek Integration** — Enter your API Key, and automatically configure V4 Pro + Flash dual-model settings.
<p align="center">
<img src="docs/screenshots/deepseek.png"><br>
<i>One-click integration with DeepSeek, no manual model parameter configuration required</i>
</p>
2. 🎭 **Role Quick Switch** — Quickly switch between preset roles, with built-in Diana, Ayase Momo, and other role templates, supporting custom creation
3. 🧩 **Skill Management** — Visual management of Skill modules, hot-swappable loading, with 5 pre-installed Skills, including Role Designer
4. 🔧 **MCP Management** — File management + Python execution, Agent can truly take action; permission approval switch + code execution pop-up confirmation
5. 📚 **Local RAG** — Build your own local knowledge base, ChromaDB vector retrieval, data stays on your local machine
6. 🧠 **Three-layer Memory** — Real-time / Short-term / Long-term, cross-session memory persistence
7. 💭 **Deep Thinking** — Supports DeepSeek deep thinking mode, more in-depth reasoning
8. 💰 **Real-time Token Billing Panel** — Real-time statistics on usage and cost, cache hits displayed separately
9. 🤖 **Context Budget Management** — 6-level priority pruning, 1M context not wasted
10. 🎨 **9 Theme Color Schemes** — One-click switching of interface theme styles
11. 📂 **Portable Operation** — All data stored in the same directory as the exe, extract and run, no installation required
## 🚀 Quick Start
### 1. Download and Install
Download the latest version from [Releases](https://github.com/Easlie114514/AICraft/releases), extract and run `AICraft.exe`
### 2. One-click DeepSeek Integration
First open → Click "Model" → Click "DeepSeek One-click Integration" → Paste API Key → Save
### 3. Start Chatting
That's it, you now have a desktop Agent with search, file management, RAG, and memory.
## 🧩 Capability Modules
| Module | Description | Pre-installed |
|------|-------------|---------------|
| **Skill** | Role-style prompt injection | 5: General / Technical / Creative / Analytical / Role Designer |
| **MCP** | Executable tools (file management + Python execution) | 2: filesystem / code_executor |
| **RAG** | Local vector retrieval (ChromaDB) | 3: User Manual / Development Guide / FAQ |
| **Memory** | Three-layer architecture (L0 real-time → L1 short-term → L2 long-term) | Automatic operation |
| **Role** | Preset personality templates | Built-in Diana, Ayase Momo, and other templates, supporting custom creation |
## 🛠️ Tech Stack
**Backend** — Python · FastAPI · ChromaDB · httpx
**Frontend** — React 19 · Vite 8 · TailwindCSS 4 · Shadcn UI
**Packaging** — PyInstaller onedir · 316 MB
## 🗺️ Future Plans
- [ ] Multi-modal input (file + image upload)
- [ ] AI-generated files (tool output CSV and other files)
- [ ] SkillHub community market
- [ ] Token billing enhancement (historical query, export)
## 📄 License
[Apache 2.0](LICENSE)
---
<p align="center">
<sub>Built with ❤️ by <a href="https://github.com/Easlie114514">Easlie</a></sub>
</p>