开放编码器

开放编码器命令行工具

在您的终端中运行的轻量级编码助手

brew tap codingmoh/open-codex && brew install open-codex

---

开放编码器 是一款完全开源的命令行 AI 助手，灵感来源于 OpenAI Codex，支持本地语言模型如 phi-4-mini，并与 Ollama 完全集成。

🧠 100% 本地运行 – 无需 OpenAI API 密钥。一切均可离线工作。

---

支持功能

• 一次性模式: open-codex "列出所有文件夹" -> 返回 shell 命令
• Ollama 集成（例如 LLaMA3、Mistral）
• 原生支持 macOS、Linux 和 Windows

---

✨ 特性

• 自然语言 → Shell 命令（通过本地或 Ollama 托管的 LLM）
• 完全本地执行：无数据上传至云端
• 在执行任何命令前进行确认
• 可选择复制到剪贴板、取消或直接执行
• 彩色终端输出，提升可读性
• Ollama 支持：使用 --ollama --model llama3 调用高级 LLM

🔍 使用 Ollama 的示例：

open-codex --ollama --model llama3 "查找所有大于 10MB 的 JPEG 文件"

Codex 将会：

1. 将您的提示发送到 Ollama API（本地服务器，例如 localhost:11434）
2. 返回一个 shell 命令建议（例如 find . -name "*.jpg" -size +10M）
3. 提示您执行、复制或取消

🛠️ 您必须在本地安装并运行 Ollama，才能使用此功能。

---

🧱 未来计划

• 交互式、上下文感知模式
• 使用 textual 或 rich 构建炫酷的 TUI 界面
• 完整的交互式聊天模式
• 函数调用支持
• 基于 Whisper 的语音输入
• 命令历史与撤销功能
• 工作流插件系统

---

📦 安装

🔹 方法 1：通过 Homebrew 安装（推荐用于 macOS）

brew tap codingmoh/open-codex
brew install open-codex

🔹 方法 2：通过 pipx 安装（跨平台）

pipx install open-codex

🔹 方法 3：克隆并本地安装

git clone https://github.com/codingmoh/open-codex.git
cd open_codex
pip install .

安装完成后，即可全局使用 open-codex 命令行工具。

---

🚀 使用示例

▶️ 一次性模式

open-codex "解压文件 abc.tar"

✅ Codex 会建议一条 shell 命令
✅ 会询问您是否确认执行、添加到剪贴板或取消
✅ 如果确认，则执行该命令

▶️ 使用 Ollama

open-codex --ollama --model llama3 "递归删除所有 .DS_Store 文件"

---

🛡️ 安全提示

所有模型均在本地运行。命令仅在您明确确认后才会执行。

---

🧑‍💻 贡献

欢迎提交 PR！无论是想法、问题还是改进，我们都十分感激。

---

📝 许可证

MIT

---

❤️ 由 codingmoh 用爱和咖啡因打造。

Open Codex 快速上手指南

Open Codex 是一款轻量级的开源命令行 AI 助手，灵感源自 OpenAI Codex。它支持在本地运行（无需联网或 API Key），可将自然语言指令转换为 Shell 命令，并完美集成 Ollama 以使用 LLaMA3、Mistral 等高级本地大模型。

环境准备

• 操作系统：macOS、Linux 或 Windows。
• 前置依赖：
  • 基础模式：无需额外依赖，安装即可使用内置轻量模型。
  • Ollama 模式（推荐）：如需使用更强大的模型（如 llama3），需先安装并运行 Ollama。
    • 安装 Ollama 后，确保本地服务正在运行（默认端口 localhost:11434）。
    • 拉取所需模型，例如：ollama pull llama3。

安装步骤

请选择以下任一方式进行安装：

方式一：Homebrew（macOS 用户推荐）

brew tap codingmoh/open-codex
brew install open-codex

方式二：pipx（跨平台通用）

确保已安装 pipx，然后执行：

pipx install open-codex

方式三：源码安装

git clone https://github.com/codingmoh/open-codex.git
cd open_codex
pip install .

基本使用

安装完成后，可在终端全局使用 open-codex 命令。工具会在执行前请求确认，确保安全性。

1. 基础模式（一键转换）

直接输入自然语言描述，工具将生成对应的 Shell 命令供你确认、复制或执行。

open-codex "untar file abc.tar"

流程：AI 建议命令 -> 询问是否执行/复制/取消 -> 确认后执行

2. 结合 Ollama 使用（推荐）

调用本地部署的强大模型（如 LLaMA3）来处理更复杂的任务。

open-codex --ollama --model llama3 "delete all .DS_Store files recursively"

执行逻辑：

1. 将提示词发送至本地 Ollama 服务。
2. 接收生成的 Shell 命令建议（例如：find . -name "*.DS_Store" -delete）。
3. 等待用户确认后方可执行，保障系统安全。