---

---

V2.1.1 新特性

• 会话持久化： 使用 /save、/load 和 /sessions 保存、加载和列出您的神经网络会话。
• 机器绑定密钥加密： 您的 API 密钥现在使用特定于设备的硬件 ID 进行加密。密钥被锁定到您的设备上，以提供专业级别的安全性。
• 配置迁移： 配置现在存储在用户主目录 (~/.hacx) 中，以便在更新时保持不变，并防止意外删除。
• 自定义本地 API 引擎： 用独立的高性能 api.py 引擎替换了 litellm 和 openai。零外部 API SDK 依赖，实现最大速度和控制。
• 推理支持： 优化了对 <think> 标签（CoT）的渲染，并配备了专门的推理面板。
• 自动更新系统： 内置更新引擎！您可以在聊天中使用 /update，或运行新的更新脚本。

---

🚀 展示

以下是 HacxGPT-CLI 的实际运行效果：

---

📋 目录

• 项目简介
  • 什么是 HacxGPT-CLI？
• 功能
• 支持的提供商与模型
• 快速入门
• 更新 HacxGPT
• 配置
• 使用方法
• 路线图
• 星标历史
• 贡献
• 许可证

---

🌟 项目简介

HacxGPT-CLI 致力于提供强大、无限制且无缝的 AI 驱动对话，突破自然语言处理和代码生成的极限。

🔍 什么是 HacxGPT-CLI？

该仓库是一个 开源命令行界面，可在几乎不受审查的情况下访问强大的 AI 模型。它通过一个 自建的本地 API 引擎，提供了一种简洁、专业的多 AI 提供商交互方式。

HacxGPT-CLI 提供的功能：

• ✅ 开源 CLI 工具，用于与 AI 模型交互
• ✅ 自定义本地 API 引擎 - 完全不依赖第三方 SDK，如 openai 或 litellm
• ✅ 支持多家提供商 - OpenRouter、Groq 和 HacxGPT API
• ✅ 高级越狱提示词，可减少模型的审查
• ✅ 多提供商支持，轻松切换不同服务
• ✅ 跨平台兼容性 - Linux、Windows、macOS、Termux
• ✅ 本地 API 密钥存储 - 您的密钥永远不会离开您的设备
• ✅ 免费使用 - 您只需提供来自各提供商的 API 密钥即可

这个仓库是什么：

• 这是一个连接到 AI 提供商的 封装/接口框架
• 使用第三方 API（OpenRouter、Groq），并结合增强的提示词
• 完全 开源且可审计 - 您可以自行检查代码
• 您的 API 密钥仅存储在 您的本地设备上
• 所有请求都 直接发送到您选择的提供商，而不是通过我们的服务器

这个仓库不是什么：

• ❌ 此代码本身并不是一个自定义的 AI 模型
• ❌ 不是一项付费服务 - 完全免费且开源
• ❌ 不会收集或存储您的任何数据
• ❌ 使用此 CLI 工具无需支付任何费用

💎 HacxGPT 生产级模型

除了这款免费的 CLI 工具外，我们还提供基于专用基础设施运行的 定制训练生产级模型，可通过 API 订阅访问。

我们的生产级产品对比：

特性	免费 CLI 工具	HacxGPT 生产级 API
技术	使用越狱提示词对接公共 API	定制训练的模型，专为编码任务优化
上下文长度	因提供商而异（4k-128k）	扩展上下文，专为大型代码库优化
方法	在现有模型上应用越狱提示词	从头开始构建，完全无审查
性能	取决于提供商	针对编码任务进行了优化
基础设施	您连接到公共 API	专用 GPU 基础设施
成本	免费（需自备 API 密钥）	需要付费订阅
支持	社区通过 GitHub/Telegram 提供支持	优先支持
适用场景	实验、学习、通用用途	生产级编码工作流、大型项目

关于 HacxGPT 生产级模型：

• ✨ 定制训练，专为编码和技术任务设计
• 🚀 扩展上下文 能力，可处理大型代码库
• 🔓 完全无审查 - 无需越狱提示词
• ⚡ 专用基础设施 - 性能稳定可靠
• 🎯 针对代码优化 - 更好地理解复杂的技术概念

访问生产级模型：

• 🌐 请访问 hacxgpt.com 了解更多信息
• 💬 加入 Telegram 获取 API 访问权限及定价详情
• 📧 如需企业级服务，请联系 contact@hacxgpt.com

---

⚡ 功能特性

这款开源命令行工具提供：

• 强大的AI对话： 获得智能且上下文感知的查询回答
• 广泛的模型支持： 可访问HacxGPT生产级模型、Groq模型以及OpenRouter的开源模型库
• 无限制框架： 专为减少传统AI局限性而设计的系统提示
• 易用的CLI： 简洁明了的命令行界面，交互顺畅
• 跨平台： 已在Kali Linux、Ubuntu、Windows、macOS和Termux上测试并正常运行
• 多提供商支持： 可无缝切换不同的AI服务提供商
• 配置管理： 内置命令用于管理API密钥和模型选择
• 本地存储： 所有配置和API密钥均安全地存储在您的设备上

---

🔌 支持的提供商与模型

HacxGPT-CLI通过多个提供商为广泛的模型提供了灵活的接口。

提供商	支持的主要模型	适用场景
HacxGPT	hacxgpt-lightning	生产环境编码、真正无审查
Groq	kimi-k2-instruct-0905, qwen3-32b
OpenRouter	mimo-v2-flash, devstral-2512, glm-4.5-air, kimi-k2, deepseek-r1t-chimera

[!TIP] 免费开始： OpenRouter和Groq都提供丰厚的免费套餐，让您无需任何费用即可试用HacxGPT-CLI。非常适合入门和尝试不同模型，如需更高级的模型，请访问hacxgpt.com查看我们的产品。

值得尝试的热门模型：

用于编码：

• hacxgpt-lightning (HacxGPT) - 我们的定制化代码优化模型
• mimo-v2-flash (OpenRouter) - 另一款优秀的编码模型。
• kimi-k2-instruct-0905 (Groq) - 非常适合编码。
• devstral-2512 (OpenRouter) - 来自Mistral AI的最新编码模型

用于推理：

• hacxgpt-lightning (HacxGPT) - 我们的定制化代码优化模型
• deepseek-r1t-chimera (OpenRouter) - 具备先进的推理能力

最佳选择：

• hacxgpt-lightning (HacxGPT) - 我们针对代码和问题解决优化的模型。

---

🚀 快速入门

按照以下步骤在您的系统上运行HacxGPT-CLI。

🔑 前提条件：API密钥

要使用本框架，您必须从至少一个支持的提供商处获取API密钥。所有提供商均提供免费套餐，非常适合入门。

选项1：OpenRouter（推荐给初学者）

1. 访问openrouter.ai/keys
2. 注册一个免费账户
3. 生成您的API密钥
4. 可访问众多强大的免费模型

选项2：Groq（适合快速响应）

1. 访问console.groq.com/keys
2. 创建一个免费账户
3. 生成您的API密钥
4. 提供非常慷慨的免费套餐，推理速度快

选项3：HacxGPT API（我们的生产级模型）

• 访问hacxgpt.com了解我们的定制模型
• 加入Telegram获取API访问权限及定价信息
• 可获得更长的上下文支持和生产级别的模型

⚙️ 安装

我们为您提供了简单的一键安装脚本，方便快捷。

Windows

1. 以管理员身份打开PowerShell。
2. 运行以下命令：

   powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/HacxGPT-Official/HacxGPT-CLI/main/scripts/install.ps1 | iex"
   

   这将下载安装程序，设置虚拟环境，并自动安装所有依赖项。

Linux / macOS / Termux

1. 打开终端
2. 运行以下命令：

   bash <(curl -s https://raw.githubusercontent.com/HacxGPT-Official/HacxGPT-CLI/main/scripts/install.sh)
   

   这将下载安装程序，使其可执行，并为您运行。

手动安装（点击展开）

如果您更倾向于手动安装，请按照以下步骤操作：

1. 克隆仓库：

   git clone https://github.com/HacxGPT-Official/HacxGPT-CLI.git
   

2. 进入目录：

   cd HacxGPT-CLI
   

3. 安装Python依赖：

   pip install -e .
   

4. 运行应用：

   hacxgpt
   # 或者
   python -m hacxgpt.main
   

🔄 更新HacxGPT

保持系统与最新功能和补丁同步。

选项A：聊天中更新（最简单）

只需在聊天会话中输入/update，工具将检查更新、拉取最新代码并自动重启。

选项B：使用脚本

• 所有平台： 运行python scripts/update.py（或在Linux/macOS上使用python3）
  • 此脚本会自动从GitHub下载最新存档，同步本地文件并更新依赖项。

选项C：主菜单

从主菜单中选择选项**[4] 系统更新**。

---

🔧 配置

HacxGPT-CLI使用集中式的providers.json文件来管理API端点和模型。您可以使用内置命令或通过设置菜单轻松切换提供商和模型。

初始设置

1. 启动工具：

   hacxgpt
   # 或者
   python -m hacxgpt.main
   

2. **选择选项[2]**以配置安全密钥

3. 选择您的提供商，并在交互式列表中选择您首选的模型

4. 在提示时输入您的API密钥——它将被本地存储在您的设备上

聊天中命令

在聊天过程中，您可以使用以下命令动态管理您的配置：

命令	描述	示例
/save <name>	保存当前会话历史	/save session1
/load <name>	加载已保存的会话	/load session1
/sessions	列出所有已保存的会话	/sessions
/setup	重新配置API密钥和默认模型	/setup
/provider <name>	在已配置的提供商之间切换	/provider openrouter
/model <name>	切换当前活动模型	/model llama-3.3-70b
/models	列出当前提供商的所有可用模型	/models
/status	显示当前配置	/status
/help	显示所有可用命令	/help
/new	清除内存并开始新会话	/new
/exit	退出应用程序	/exit

---

👀 使用方法

直接运行应用程序：

hacxgpt
# 或者
python -m hacxgpt.main

首次运行时，系统会提示您输入API密钥。该密钥将被本地保存，以便在后续会话中使用。

获得最佳效果的提示

• 从免费服务商开始 - 使用 OpenRouter 或 Groq 无需付费即可试用该工具

• 切换模型 - 使用 /models 查看可用选项，使用 /model 切换模型

• 检查配置 - 使用 /status 验证当前设置

• 尝试不同服务商 - 每家都有其优势；多加试验以找到最适合你的方案

• 用于生产环境 - 如需最佳性能，请考虑 HacxGPT API，访问 hacxgpt.com。

---

🗺️ 路线图

我们正在不断改进 HacxGPT-CLI。以下是目前我们计划实现的一些技术里程碑：

• 高级推理支持： 用于复杂问题解决的深度思考与推理能力
• 对话管理： 保存、加载并恢复对话
• 智能体能力： 自主使用工具及多步骤执行链
• 网络搜索集成： 实时数据检索，获取最新上下文
• 高级文件分析： 原生支持处理大型数据集和文档
• IDE 集成： 为 VS Code、IntelliJ 等流行编辑器提供插件
• 多模态支持： 图像和文档分析能力
• 自定义提示模板： 针对特定任务的用户定义系统提示
• 服务商自动切换： 根据任务类型自动切换服务商

---

⭐ 星标历史

---

🤝 贡献

正是贡献让开源社区成为一个令人惊叹的学习、启发与创造之地。你所做的任何贡献都将受到高度赞赏。

如何贡献

1. Fork 项目
2. 创建你的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m '添加一些AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

我们需要帮助的领域

• 🐛 修复 bug 和测试 - 帮助我们发现并修复问题
• 📝 改进文档 - 让我们的文档更清晰、更全面
• 🎨 UI/UX 改进 - 提升 CLI 的用户体验
• 🔌 新增 AI 服务商 - 添加对更多 AI 服务的支持
• 🌐 翻译 - 帮助 HacxGPT-CLI 走向全球
• 💡 功能实现 - 构建新能力
• 🧪 测试覆盖率 - 增加测试以提高可靠性

行为准则

我们致力于提供一个友好且包容的环境。请：

• 在讨论中保持尊重与建设性
• 关注代码和想法，而非个人
• 帮助新手学习并参与贡献
• 通过正规渠道报告问题

---

⚖️ 许可证

根据个人使用许可协议 (PUOL) 1.0 发布。更多信息请参阅 LICENSE。

要点：

• ✅ 供个人免费使用
• ✅ 开源，可用于学习和贡献
• ✅ 可被 fork 并修改用于个人项目
• ⚠️ 商业用途需另行授权

---

🔗 重要链接

HacxGPT 相关资源：

• 🌐 官网： hacxgpt.com - 了解我们的生产级模型
• 💬 Telegram 社区： t.me/HacxGPT - 社区支持与公告
• 📧 邮箱： contact@hacxgpt.com - 直接联系
• 🐙 GitHub 组织： @HacxGPT-Official

项目相关资源：

• 📚 仓库： HacxGPT-CLI
• 🐛 问题追踪： 报告 bug

---

📞 支持

需要帮助吗？有问题吗？

社区支持：

• 💬 Telegram： 加入我们的 社区 获取帮助与讨论
• 🐛 Bug 报告： 在 GitHub 上 提交问题

生产支持：

• 🌐 如需 HacxGPT API 支持，请访问 hacxgpt.com
• 📧 如有业务咨询，请发送邮件至 contact@hacxgpt.com

---

⚠️ 免责声明

本工具专为教育和研究目的而设计。用户有责任确保其使用符合相关法律法规以及所访问任何第三方 API 的服务条款。

重要提示：

• ⚠️ OpenRouter 免费层级： OpenRouter 上的免费模型经常离线或变更。若某个模型不可用，请尝试其他模型。
• ⚠️ API 使用： 使用第三方服务商（OpenRouter、Groq）时，您需遵守其服务条款和隐私政策
• ⚠️ 数据隐私： 您的提示将发送至您选择的服务商——而非我们
• ⚠️ API 密钥： 请妥善保管您的 API 密钥，切勿分享
• ⚠️ 越狱提示： 减少审查的系统提示可能违反某些服务商的服务条款
• ⚠️ 责任： 您需对如何使用本工具自行负责

HacxGPT-CLI 的开发者：

• 不会收集或存储您的 API 密钥或提示
• 对本软件的滥用不承担任何责任
• 不保证本工具能长期与所有服务商兼容
• 鼓励负责任且合法地使用 AI 技术

---

🙏 致谢

本项目得益于众多前辈的工作。我们感谢：

• OpenRouter 提供了多种 AI 模型的访问权限
• Groq 提供了快速推理能力和慷慨的免费层级
• 开源社区 提供的工具、库与灵感
• 所有贡献者 对本项目的持续改进
• 我们的用户 提供的反馈、bug 报告和支持

---

---

HacxGPT-CLI 快速上手指南

HacxGPT-CLI 是一个开源的命令行工具，旨在通过自定义本地 API 引擎，让用户无限制地访问强大的 AI 模型（如 Groq、OpenRouter 及 HacxGPT 生产模型）。它不依赖第三方 SDK，支持跨平台运行，并提供减少内容审查的系统提示框架。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：支持 Linux (包括 Kali, Ubuntu), macOS, Windows (PowerShell), 以及 Termux (Android)。
• Python 环境：需安装 Python 3.x（推荐最新稳定版）。
• 网络环境：由于需要连接海外 AI 服务商（OpenRouter, Groq 等），请确保网络畅通。
  • 注：本项目暂无官方国内镜像源，若下载脚本缓慢，建议配置全局代理或使用加速节点。
• API 密钥（必需）：使用前需至少拥有一个支持的服务商 API Key。
  • OpenRouter (推荐新手): openrouter.ai/keys - 提供丰富的免费模型额度。
  • Groq: console.groq.com/keys - 以极速推理著称，免费额度慷慨。
  • HacxGPT: hacxgpt.com - 专为代码优化的定制模型（付费/订阅制）。

安装步骤

项目提供了一键安装脚本，自动处理虚拟环境和依赖安装。

Windows 用户

1. 以管理员身份打开 PowerShell。
2. 执行以下命令：

   powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/HacxGPT-Official/HacxGPT-CLI/main/scripts/install.ps1 | iex"
   

Linux / macOS / Termux 用户

1. 打开终端。
2. 执行以下命令：

   bash <(curl -s https://raw.githubusercontent.com/HacxGPT-Official/HacxGPT-CLI/main/scripts/install.sh)
   

手动安装备选方案： 若脚本执行失败，可手动克隆并安装：

git clone https://github.com/HacxGPT-Official/HacxGPT-CLI.git
cd HacxGPT-CLI
pip install -e .

基本使用

安装完成后，按照以下步骤配置并开始对话。

1. 启动与配置

运行主程序进入交互菜单：

hacxgpt
# 或者
python -m hacxgpt.main

首次使用时，请按以下流程操作：

1. 在主菜单中选择 [2] Configure Security Keys（配置安全密钥）。
2. 选择您拥有的服务商（如 OpenRouter 或 Groq）。
3. 从列表中选择想要的模型（例如 mimo-v2-flash 或 kimi-k2-instruct-0905）。
4. 粘贴您的 API Key。密钥将加密存储于本地 (~/.hacx)，不会上传至第三方服务器。

2. 开始对话

配置完成后，返回主菜单选择 [1] Start Chat 或直接进入对话界面。

常用操作示例：

• 发送消息：直接输入文本并回车。

  请帮我写一个 Python 脚本来抓取网页标题。
  

• 切换模型：在对话中输入 /model 可临时切换其他已配置的模型。
• 保存会话：输入 /save 保存当前对话上下文。
• 加载会话：输入 /load 恢复之前的对话。
• 查看会话列表：输入 /sessions 列出所有保存的会话。
• 更新工具：输入 /update 自动检查并升级到最新版本。

3. 推荐模型速查

• 代码生成：hacxgpt-lightning (HacxGPT), devstral-2512 (OpenRouter), kimi-k2-instruct-0905 (Groq)
• 逻辑推理：deepseek-r1t-chimera (OpenRouter), hacxgpt-lightning
• 快速响应：mimo-v2-flash (OpenRouter)

现在您可以尽情享受无限制、高性能的 AI 编程与对话体验了。