文章目录
一、关于
Open Interpreter(开放解释器) 可以让大语言模型(LLMs)在本地运行代码(比如 Python、JavaScript、Shell 等)。安装后,在终端上运行 $ interpreter
即可通过类似 ChatGPT 的界面与 Open Interpreter 聊天。
- github:https://github.com/OpenInterpreter/open-interpreter
- 官网:https://www.openinterpreter.com/
- 文档:https://docs.openinterpreter.com/
- discord : https://discord.gg/Hvz9Axh84z
- interactive demo : https://colab.research.google.com/drive/1WKmRXZgsErej2xUriKzxrEAXdxMSgWbb?usp=sharing
- voice interface, inspired by Her : https://colab.research.google.com/drive/1NojYGHDgxH6Y1G1oxThEBBb2AtyODBIK
本软件为计算机的通用功能提供了一个自然语言界面,比如:
- 创建和编辑照片、视频、PDF 等
- 控制 Chrome 浏览器进行搜索
- 绘制、清理和分析大型数据集
- ...
⚠️ 注意:在代码运行前都会要求您批准执行代码。
演示
它是如何工作的?
Open Interpreter 为函数调用语言模型配备了 exec()
函数,该函数接受 编程语言
(如 "Python "或 "JavaScript")和要运行的 代码
。
然后,它会将模型的信息、代码和系统的输出以 Markdown 的形式流式传输到终端。
与 ChatGPT 的代码解释器比较
OpenAI 发布的 Code Interpreter 和 GPT-4 提供了一个与 ChatGPT 完成实际任务的绝佳机会。
但是,OpenAI 的服务是托管的,闭源的,并且受到严格限制:
- 无法访问互联网。
- 预装软件包数量有限。
- 允许的最大上传为 100 MB,且最大运行时间限制为 120.0 秒
- 当运行环境中途结束时,之前的状态会被清除(包括任何生成的文件或链接)。
Open Interpreter(开放解释器)通过在本地环境中运行克服了这些限制。它可以完全访问互联网,不受运行时间或是文件大小的限制,也可以使用任何软件包或库。
它将 GPT-4 代码解释器的强大功能与本地开发环境的灵活性相结合。
二、快速开始
安装
shell
pip install open-interpreter
安装后,要在终端中开始交互式聊天,运行:
shell
interpreter
Python 调用
python
from interpreter import interpreter
interpreter.chat("Plot AAPL and META's normalized stock prices") # 执行单一命令
interpreter.chat() # 开始交互式聊天
三、更多操作
更新:生成器更新(0.1.5)引入了流:
shell
message = "What operating system are we on?"
for chunk in interpreter.chat(message, display=False, stream=True):
print(chunk)
1、互动聊天
要在终端中开始交互式聊天,请从命令行运行interpreter
:
shell
interpreter
或interpreter.chat()
从. py文件:
shell
interpreter.chat()
您还可以流式传输每个块:
shell
message = "What operating system are we on?"
for chunk in interpreter.chat(message, display=False, stream=True):
print(chunk)
2、程序化聊天
为了更精确的控制,您可以通过 .chat(message)
直接传递消息 :
python
interpreter.chat("Add subtitles to all videos in /videos.")
# ... Streams output to your terminal, completes task ...
interpreter.chat("These look great but can you make the subtitles bigger?")
# ...
3、开始新的聊天
在 Python 中,Open Interpreter 会记录历史对话。如果你想从头开始,可以进行重置:
python
interpreter.messages = []
4、保存和恢复聊天
interpreter.chat()
()返回一个消息列表,可用于恢复与interpreter.messages = messages
:
python
messages = interpreter.chat("My name is Killian.") # 保存消息到 'messages'
interpreter.messages = [] # 重置解释器 ("Killian" 将被遗忘)
interpreter.messages = messages # 从 'messages' 恢复聊天 ("Killian" 将被记住)
5、自定义系统消息
你可以检查和配置 Open Interpreter 的系统信息,以扩展其功能、修改权限或赋予其更多上下文。
python
interpreter.system_message += """
使用 -y 运行 shell 命令,这样用户就不必确认它们。
"""
print(interpreter.system_message)
6、更改模型
Open Interpreter 使用LiteLLM连接到语言模型。
您可以通过设置模型参数来更改模型:
python
interpreter --model gpt-3.5-turbo
interpreter --model claude-2
interpreter --model command-nightly
在 Python 环境下,您需要手动设置模型:
python
interpreter.llm.model = "gpt-3.5-turbo"
7、在本地运行 Open Interpreter
终端
Open解释器可以使用与OpenAI兼容的服务器在本地运行模型。(LM Studio、jan.ai、ollama等)
只需使用推理服务器的api_baseURL运行interpreter
(对于LM Studio,默认http://localhost:1234/v1
):
shell
interpreter --api_base "http://localhost:1234/v1" --api_key "fake_key"
或者,您可以使用Llamafile而无需安装任何第三方软件,只需运行
shell
interpreter --local
有关更详细的指南,请查看Mike Bird的此视频
如何在后台运行LM Studio。
- 下载https://lmstudio.ai/然后启动它。
- 选择型号,然后单击↓下载。
- 单击左侧(💬下方)的↔️按钮。
- 在顶部选择您的模型,然后单击启动服务器。
服务器运行后,您可以使用Open解释器开始对话。
**注意:**本地模式将您的
context_window
设置为3000,max_tokens
为1000。如果您的型号有不同的要求,请手动设置这些参数(见下文)。
Python
我们的Python包让您可以更好地控制每个设置。要复制并连接到LM Studio,请使用以下设置:
shell
from interpreter import interpreter
interpreter.offline = True # Disables online features like Open Procedures
interpreter.llm.model = "openai/x" # Tells OI to send messages in OpenAI's format
interpreter.llm.api_key = "fake_key" # LiteLLM, which we use to talk to LM Studio, requires this
interpreter.llm.api_base = "http://localhost:1234/v1" # Point this at any OpenAI compatible server
interpreter.chat()
上下文窗口,最大令牌
您可以修改本地运行模型的max_tokens
和context_window
(以令牌形式)。
对于本地模式,较小的上下文窗口将使用较少的RAM,因此如果失败/速度较慢,我们建议尝试更短的窗口(约1000)。确保max_tokens
小于context_window
。
shell
interpreter --local --max_tokens 1000 --context_window 3000
8、Verbose 模式
为了帮助您检查开放解释器,我们有一个用于调试的--verbose
模式。
您可以使用它的标志(interpreter --verbose
)或聊天中激活详细模式:
shell
$ interpreter
...
> %verbose true <- Turns on verbose mode
> %verbose false <- Turns off verbose mode
9、交互模式命令
在交互模式下,您可以使用以下命令来增强您的体验。以下是可用命令列表:
可用命令:
%verbose [true/false]
:切换详细模式。不带参数或带true
参数 进入详细模式。使用false
则退出详细模式。%reset
:重置当前会话的对话。%undo
:从消息历史记录中删除上一条用户消息和AI的响应。%tokens [prompt]
:(实验 )计算将与下一个提示作为上下文一起发送的令牌,并估计它们的成本。如果提供了prompt
,可以选择计算令牌和估计成本。依赖于LiteLLM的cost_per_token()
方法来估计成本。%help
:显示帮助消息。
10、Configuration / Profiles
打开解释器允许您使用yaml
文件设置默认行为。
这提供了一种灵活的方式来配置解释器,而无需每次都更改命令行参数。
运行以下命令打开配置文件目录:
shell
interpreter --profiles
您可以在那里添加yaml
文件。默认配置文件名为default.yaml
。
多个配置文件
Open解释器支持多个yaml
文件,允许您在配置之间轻松切换:
shell
interpreter --profile my_profile.yaml
四、示例FastAPI服务器
生成器更新使Open解释器能够通过HTTP REST端点进行控制:
shell
# server.py
from fastapi import FastAPI
from fastapi.responses import StreamingResponse
from interpreter import interpreter
app = FastAPI()
@app.get("/chat")
def chat_endpoint(message: str):
def event_stream():
for result in interpreter.chat(message, stream=True):
yield f"data: {result}\n\n"
return StreamingResponse(event_stream(), media_type="text/event-stream")
@app.get("/history")
def history_endpoint():
return interpreter.messages
shell
pip install fastapi uvicorn
uvicorn server:app --reload
您也可以通过简单地运行 interpreter.server()
来启动与上述服务器相同的服务器。
调试模式
为了帮助贡献者检查和调试 Open Interpreter,--verbose
模式提供了详细的日志。
您可以使用 interpreter --verbose
来激活调试模式,或者直接在终端输入:
python
$ interpreter
...
> %verbose true <- 开启调试模式
> %verbose false <- 关闭调试模式
五、其他
1、安卓系统
在Android设备上安装Open解释器的分步指南可在open-interpreter-termux 存储库中找到。
2、离线访问文档
完整的留档可随时随地访问,无需互联网连接。
节点是一个先决条件:
- 版本 18.17.0 或任何更高版本 18.x.x 版本。
- 版本 20.3.0 或任何更高版本 20.x.x 。
- 从 21.0.0 开始的任何版本,没有指定上限。
安装Mintlify:
shell
npm i -g mintlify@latest
切换到docs目录并运行相应的命令:
shell
# Assuming you're at the project's root directory
cd ./docs
# Run the documentation server
mintlify dev
应该会打开一个新的浏览器窗口。只要留档服务器在运行,留档就http://localhost:3000可用。
3、安全提示
由于生成的代码是在本地环境中运行的,因此会与文件和系统设置发生交互,从而可能导致本地数据丢失或安全风险等意想不到的结果。
⚠️ 所以在执行任何代码之前,Open Interpreter 都会询问用户是否运行。
您可以运行 interpreter -y
或设置 interpreter.auto_run = True
来绕过此确认,此时:
- 在运行请求修改本地文件或系统设置的命令时要谨慎。
- 请像驾驶自动驾驶汽车一直握着方向盘一样留意 Open Interpreter,并随时做好通过关闭终端来结束进程的准备。
- 考虑在 Google Colab 或 Replit 等受限环境中运行 Open Interpreter 的主要原因是这些环境更加独立,从而降低执行任意代码导致出现问题的风险。
有实验性 支持的安全模式,以帮助减轻一些风险。
4、Roadmap
若要预览 Open Interpreter 的未来,请查看我们的路线图 。
请注意:此软件与 OpenAI 无关。
2024-08-03(六)