Open Interpreter をしばらく触ってみたので Tips をメモする

# はじめに

Open Interpreter をしばらく触ってみたので、 Open Interpreter とは何なのか、導入や使用時の Tips についてまとめてみます。

この記事内での Open Interpreter のバージョンは、特に断りがなければ v0.1.16 について言及しているものとします。v0.2.0で破壊的変更が加わったため、一部説明が最新版とは異なる場合があります。

# Open Interpreter とは

Open Interpreterは自然言語による対話を通じてローカル環境でコード実行ができるオープンソースのツールです。

https://github.com/KillianLucas/open-interpreter/tree/v0.1.16

ChatGPTのAdvanced Data Analysis (ADA; 旧Code Interpreter)は処理できるファイルの種類やアップロードできるファイルのサイズなどに制限がありますが、Open Interpreterはローカルでコードを実行できこれらの制限を受けないため[^oi-ada-comparison]話題になりました。

[^oi-ada-comparison]: https://github.com/KillianLucas/open-interpreter/tree/v0.1.16#comparison-to-chatgpts-code-interpreter

## 競合選択肢

### OpenAI Assistants API

2023年11月のOpenAI DevDayで発表されたAPI[^oai-devday]で、内部でCode Interpreterが使えます。2024年1月現在はBeta版です。

ファイルサイズなどAdvanced Data Analysisと同様の制限があるようですが、それらが問題にならず、Advanced Data Analysisと同様のことをAPIから行いたいならば、こちらが選択肢になりそうです。

[^oai-devday]: https://openai.com/blog/new-models-and-developer-products-announced-at-devday

https://platform.openai.com/docs/assistants/tools/code-interpreter

https://note.com/npaka/n/nb90306341d41


Azure OpenAI Serviceの方ですが、2023年11月のMSのブログでAssistants APIの状況についてComing Soonと記されていますが[^ms-oai-announces]、それ以降の情報は見当たらず2024年1月現在は公開されていないようです。

[^ms-oai-announces]: https://techcommunity.microsoft.com/t5/ai-azure-ai-services-blog/azure-openai-service-announces-new-models-and-multimodal/ba-p/3978865

### Code Interpreter API

LangChain を用いた Code Interpreter のAPI実装です。コードの実行環境は同じ作者が開発中の CodeBox というサービス上で動かすようになっているようです。

ただし CodeBox の API key を環境変数に設定しなければ、コード実行はローカルのサンドボックスで行われるようです[^codebox-local]。ローカル実行する場合のサンドボックスの実体は Jupyter Kernel のようです[^localbox-jupyter]。


https://github.com/shroominic/codeinterpreter-api/tree/v0.1.15

https://zenn.dev/karaage0703/articles/04f585d1d46979

[^codebox-local]: https://github.com/shroominic/codebox-api/blob/v0.0.19/codeboxapi/box/codebox.py#L54-L64

[^localbox-jupyter]: https://github.com/shroominic/codebox-api/blob/v0.0.19/codeboxapi/box/localbox.py#L77-L90

## ライセンス

Open Interpreter のソフトウェアライセンスは v0.1.16 までは MIT でしたが v0.1.17 から AGPL に変更されたようです[^oi-v0116-license] [^oi-v0117-license]。

[^oi-v0116-license]: https://github.com/KillianLucas/open-interpreter/blob/v0.1.16/LICENSE
[^oi-v0117-license]: https://github.com/KillianLucas/open-interpreter/blob/v0.1.17/LICENSE

ライセンスがAGPLであるソフトウェアはライブラリとして直接リンクして第3者に提供すると、コピーレフトが適用されリンクしたアプリケーションコードの開示義務も発生するようなので、サービスに組み込む場合は注意が必要そうです。

https://future-architect.github.io/articles/20220929a/


## Open Interpreter の仕組み

以下の記事が詳しいです。

https://tech.every.tv/entry/2023/10/11/152257

Open Interpreterはユーザーの指示からプロンプトを作成し、プロンプトをもとにLLMにコードを生成させます。

生成したコードをローカルで実行し、その結果をもとに、エラーを修正する、次のサブタスクを処理するなどしながら与えられたタスクを処理します。

![](https://cdn-ak.f.st-hatena.com/images/fotolife/N/Noleff/20231011/20231011145613.png)

画像出典: https://tech.every.tv/entry/2023/10/11/152257

Open Interpreterのデフォルトシステムプロンプトの1行目は以下のようになっており[^oi-sys-prompt]、指示に対しコード実行によってタスクを完了する、プログラマー的役割を担うものとしてデザインされています。

[^oi-sys-prompt]: https://github.com/KillianLucas/open-interpreter/blob/v0.1.16/interpreter/terminal_interface/config.yaml#L2

```
You are Open Interpreter, a world-class programmer that can complete any goal by executing code.
```

LLMに自然言語処理的タスクをさせたい場合など、コード実行を期待しない場合はミスマッチとなりそうです。

# Open Interpreter の導入

## 動作環境の用意

Open Interpreter 自体は pip コマンド一発で入ります。

ただしOpen Interpreterが生成するコードはローカルで実行されるので、VMやdockerなど壊れても問題ない環境を用意しておいた方が無難です。

# モデルの選択肢

私は Azure OpenAI Service の GPT-4 を使いました。

Azure OpenAI以外にも以下のページに記載があるモデルを使用可能のようです。

https://docs.openinterpreter.com/language-model-setup/introduction

またOpen Interpreter は LLM のAPI呼び出しに LiteLLM を使用しているので、 LiteLLM が対応しているプロバイダーであれば上記ページに記載がないモデルでも使用できそうです。

https://docs.litellm.ai/docs/providers/

 ローカルLLMも使用可能で、 OpenAI API 互換のエンドポイントであり、Open Interpreter側でもエンドポイントを指定しているだけなので[^oi-localopt]、LM Studioに限定されているわけではありません。

[^oi-localllm]: https://github.com/KillianLucas/open-interpreter/tree/v0.1.16#running-open-interpreter-locally

[^oi-localopt]: https://github.com/KillianLucas/open-interpreter/blob/v0.1.16/interpreter/terminal_interface/start_terminal_interface.py#L201-L210

# UI の選択肢

Open Interpreter は terminal インターフェースと python インターフェースを有しています。

## Jupyter

python インターフェースが Jupyterでの表示に対応していたので、私は主にJupyter Labで使っていました。

会話履歴がNotebook上にそのまま残ってくれることを期待しましたが、Notebookを開きなおすと表示が消えます[^oi-output-disappiear]。

[^oi-output-disappiear]: https://github.com/KillianLucas/open-interpreter/issues/411

またmatplotlibで作成したグラフも画面には表示されないので、ファイルとして保存してから確認する必要があります。

Feature Requestのissueは立っているので[^oi-jupyter-request]、もしかしたらそのうち改善されるかもしれません。

[^oi-jupyter-request]: https://github.com/KillianLucas/open-interpreter/issues/52

## OpenInterpreterUI

StreamlitによるサードパーティーのUI実装です。2023年10月のOpen Interpreter Hackathon[^oi-hackathon]で作られたもので、あまり活発には開発されていなさそうです。

https://github.com/blazzbyte/OpenInterpreterUI

[^oi-hackathon]: https://lablab.ai/event/open-interpreter-hackathon

# 操作Tips

## コード実行時の確認をスキップする

デフォルトではコードを実行する度に確認が求められますが、面倒なので確認なしで実行できるようにします。ただし無限ループに入るなどしてLLMにリクエストし続け、多額の請求が来たら困るので、バジェットを設定しておきます。

```python
import interpreter

agent = interpreter.Interpreter()
agent.max_budget = 1
agent.auto_run = True
```

## 指示をやりなおす

`%undo` を入力すると直近のユーザープロンプトを会話履歴から削除できるので、指示をやり直したいときなどに使えます。

```python
agent.chat("%undo")
```

頭に `%` が付くコマンドは Interactive Mode Command というもので `%undo` 以外にも種類があります。

https://github.com/KillianLucas/open-interpreter/tree/v0.1.16?tab=readme-ov-file#interactive-mode-commands

## システムプロンプトに指示を追加して、ふるまいを調整する

Open Interpreterのシステムプロンプトはユーザーにより変更できるようになっています。

システムプロンプトが英語だからなのか、ユーザープロンプトを日本語で与えても、会話しているうちにOpen Interpreterの応答が英語になることがあります。私は常に日本語で応答してほしかったので、以下のような文をシステムプロンプトに追加しました。

```python
agent.system_prompt += """
Regardless of the prompt language, write messages to the user in Japanese.
"""
```

# おわりに

この記事をまとめているうちに v0.2.0 がリリースされていました。新機能の追加や破壊的変更があるようです。

https://github.com/KillianLucas/open-interpreter/releases/tag/v0.2.0

https://changes.openinterpreter.com/log/the-new-computer-update

https://github.com/KillianLucas/open-interpreter/blob/main/docs/NCU_MIGRATION_GUIDE.md