Openinterpreter AI Agent

<h1 align="center">Open Interpreter</h1> <p align="center">A coding agent optimized for low-cost models. <a href="https://www.openinterpreter.com/blog/open-interpreter?utm_source=github&amp;utm_medium=referral&amp;utm_campaign=readme&amp;utm_content=hero_text"><strong>Blog post ↗</strong></a></p> <p align="center"> <b>English</b> • <a href="README_ES.md">Español</a> • <a href="README_ZH.md">简体中文</a> • <a href="README_JA.md">日本語</a> </p> <p align="center"> <a href="https://discord.gg/Hvz9Axh84z"><img alt="Discord" src="https://img.shields.io/discord/1146610656779440188?style=flat-square&label=Discord" /></a> <a href="https://www.openinterpreter.com/docs/terminal?utm_source=github&amp;utm_medium=referral&amp;utm_campaign=readme&amp;utm_content=docs_badge"><img alt="Documentation" src="https://img.shields.io/badge/Documentation-white?style=flat-square" /></a> <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-white?style=flat-square" /></a> </p>

[!NOTE] Today: Kimi K3 is here. We have reimplemented the provider-recommended Kimi Code harness in Rust, giving you maximum K3 performance with a Codex-like interface. Kimi Docs →

<br> <p align="center"> <a href="https://www.openinterpreter.com/blog/open-interpreter?utm_source=github&amp;utm_medium=referral&amp;utm_campaign=readme&amp;utm_content=hero_image"> <img alt="Open Interpreter running in a terminal" src="docs-site/assets/open-interpreter-terminal-hero.png" width="100%" /> </a> </p>

Installation

macOS and Linux:

curl -fsSL https://www.openinterpreter.com/install | sh

Windows:

irm https://www.openinterpreter.com/install.ps1 | iex

Then type i or interpreter in your terminal to start a session.

Harness Emulation

Open Interpreter is a fork of OpenAI's Codex, with a focus on emulating the agent harness that gets the best performance out of low-cost models.

Use /harness to switch the active harness:

> /harness

native
claude-code
claude-code-bare
zcode
kimi-code
kimi-cli
qwen-code
deepseek-tui
swe-agent
minimal

Read more in the harness docs and provider setup guides.

ACP compatible, Codex compatible

Open Interpreter works in ACP-compatible editors and clients. Configure the client to launch interpreter acp; see the ACP guide for examples.

Already building with OpenAI's Codex SDK? Keep the SDK and make a one-line binary override:

-const codex = new Codex();
+const codex = new Codex({ codexPathOverride: "interpreter" });

Open Interpreter speaks the same Codex exec protocol. See the SDK guide and run scripts/test-codex-sdk-compat.sh for a local, provider-free compatibility check.

Want a small browser UI over raw Open Interpreter? Start with the local streaming web chat guide. For a complete desktop, browser, or headless client, use Interpreter Workstation.

Portable by default

Open Interpreter should fit into your existing agent setup instead of trapping it in an Open Interpreter-only format. The product goal is to prefer shared, tool-neutral standards and directories, keep user-authored data in readable files, and make moving to or from another compatible agent straightforward.

Today that includes repository AGENTS.md, shared .agents/skills directories, MCP, ACP, and the Codex exec protocol. Product-specific storage under ~/.openinterpreter is reserved for configuration and runtime state that does not yet have a practical shared standard. Legacy product-specific skill directories remain readable for compatibility, but new skills belong in .agents/skills or ~/.agents/skills.

See the portability guide for the current boundary and the rules for evolving it.

Computer Use

Open Interpreter ships with a QA skill that lets any model operate and test interfaces. It can drive web apps in a real browser with agent-browser, or operate and test native apps with trycua.

Features

• Runs commands inside native sandboxing on macOS, Linux, and Windows.
• Switches providers and models from the TUI with /model.
• Runs any selected OpenAI-compatible provider through Chat Completions with interpreter --chat-completions or interpreter exec --chat-completions.
• Inspects or switches Rust-native model harnesses with /harness.
• Tests web and native apps through the built-in QA skill.
• Runs as an Agent Client Protocol agent for editors with interpreter acp.
• Reuses shared AGENTS.md instructions and .agents/skills directories.
• Keeps product-only config and session state local under ~/.openinterpreter.
• Supports exec, MCP, skills, hooks, permissions, and AGENTS.md.

Documentation

• Terminal docs
• Quickstart
• Install guide
• Configuration
• CLI reference
• Harnesses
• Model provider guides
  • Kimi K3
  • DeepSeek
  • Z.AI, GLM, and ZCode
• Agent Client Protocol
• Codex SDK
• Portability
• Sandbox & approvals
• Branding a distribution fork

Provider and model membership is generated, not maintained as Rust lists. From codex-rs, refresh all hosted providers with python3 scripts/write_provider_catalog.py, or repeat --provider <provider-id> to update only selected provider entries. Live model sources require the provider credentials documented in the provider docs.

[!NOTE] This is the new Rust version of Open Interpreter, based on Codex. Looking for the original Python project? It lives on as a community-maintained fork at endolith/open-interpreter.

License

Apache-2.0