Skip to content

codingmoh / **open-codex ** Public

Fully open-source command-line AI assistant inspired by OpenAI Codex, supporting local language models.

License

MIT license 24 stars 1 fork

codingmoh/open-codex

master

Code

Folders and files

Name| Name| Last commit message| Last commit date
---|---|---|---
.github| .github
src/open_codex| src/open_codex
.gitignore| .gitignore
.python-version| .python-version
LICENSE.md| LICENSE.md
README.md| README.md
pyproject.toml| pyproject.toml
uv.lock| uv.lock

Open Codex

Open Codex CLI

Lightweight coding agent that runs in your terminal brew tap codingmoh/open-codex brew install open-codex

Open Codex 是一个完全开源的命令行 AI 助手，其灵感来源于 OpenAI Codex，支持本地语言模型，例如 phi-4-mini。

无需 API 密钥。 所有操作都在本地运行。

支持：

• One-shot mode : open-codex "list all folders" -> 返回 shell 命令
• 🧠 使用支持的操作系统模型（目前为 phi-4-mini）进行纯本地执行

✨ Features

• 自然语言到 Shell 命令（通过本地模型）
• 可在 macOS、Linux 和 Windows 上运行（基于 Python）
• 执行前确认
• 添加到剪贴板 / 中止 / 执行提示
• One-shot 交互模式（交互式和函数调用即将推出）
• 彩色终端输出，以提高可读性

🧱 Future Plans

• 交互式、上下文感知模式
• 使用 textual 或 rich 的精美 TUI
• 增加对其他 OSS 模型 的支持
• 完整的交互式聊天模式
• 函数调用支持
• 通过 Whisper 进行语音输入
• 命令历史记录和撤消
• 工作流插件系统

📦 Installation

🔹 Option 1: 通过 Homebrew 安装（推荐用于 MacOS）

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

🔹 Option 2: 通过 pipx 安装（跨平台）

pipx install open-codex

🔹 Option 3: 克隆并在本地安装

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

安装完成后，您可以在全局使用 open-codex CLI。

🚀 Usage

One-shot mode

open-codex "untar file abc.tar"

✅ Codex 建议一个 shell 命令 ✅ 请求确认 / 添加到剪贴板 / 中止 ✅ 如果获得批准则执行

🛡️ Security Notice

所有模型都在本地运行。 命令仅在明确批准后执行。

🧑‍💻 Contributing

欢迎提交 PR！ 想法、问题、改进意见 - 非常感谢。

📝 License

MIT

❤️ 由 codingmoh 用爱和咖啡因构建。