Skip to content

Commit d5dfbf8

Browse files
authored
Merge pull request #1683 from endolith/classic/README_install
README improvements
2 parents 06c796a + 1730ba3 commit d5dfbf8

1 file changed

Lines changed: 13 additions & 27 deletions

File tree

README.md

Lines changed: 13 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,8 @@
1515

1616
<br>
1717

18-
<img alt="local_explorer" src="https://github.com/OpenInterpreter/open-interpreter/assets/63927363/d941c3b4-b5ad-4642-992c-40edf31e2e7a">
18+
![local_explorer](https://github.com/OpenInterpreter/open-interpreter/assets/63927363/d941c3b4-b5ad-4642-992c-40edf31e2e7a)
1919

20-
<br>
21-
</p>
2220
<br>
2321

2422
**Open Interpreter** lets LLMs run code (Python, Javascript, Shell, and more) locally. You can chat with Open Interpreter through a ChatGPT-like interface in your terminal by running `$ interpreter` after installing.
@@ -36,19 +34,18 @@ This provides a natural-language interface to your computer's general-purpose ca
3634

3735
## Demo
3836

39-
https://github.com/OpenInterpreter/open-interpreter/assets/63927363/37152071-680d-4423-9af3-64836a6f7b60
37+
[Demo video](https://github.com/OpenInterpreter/open-interpreter/assets/63927363/37152071-680d-4423-9af3-64836a6f7b60)
4038

41-
#### An interactive demo is also available on Google Colab:
39+
### An interactive demo is also available on Google Colab
4240

4341
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1WKmRXZgsErej2xUriKzxrEAXdxMSgWbb?usp=sharing)
4442

45-
#### Along with an example voice interface, inspired by _Her_:
43+
### Along with an example voice interface, inspired by _Her_
4644

4745
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1NojYGHDgxH6Y1G1oxThEBBb2AtyODBIK)
4846

4947
## Quick Start
5048

51-
5249
### Install
5350

5451
```shell
@@ -85,7 +82,7 @@ OpenAI's release of [Code Interpreter](https://openai.com/blog/chatgpt-plugins#c
8582
However, OpenAI's service is hosted, closed-source, and heavily restricted:
8683

8784
- No internet access.
88-
- [Limited set of pre-installed packages](https://wfhbrian.com/mastering-chatgpts-code-interpreter-list-of-python-packages/).
85+
- [Limited set of pre-installed packages](https://wfhbrian.com/artificial-intelligence/mastering-chatgpts-code-interpreter-list-of-python-packages/).
8986
- 100 MB maximum upload, 120.0 second runtime limit.
9087
- State is cleared (along with any generated files or links) when the environment dies.
9188

@@ -97,15 +94,6 @@ This combines the power of GPT-4's Code Interpreter with the flexibility of your
9794

9895
## Commands
9996

100-
**Update:** The Generator Update (0.1.5) introduced streaming:
101-
102-
```python
103-
message = "What operating system are we on?"
104-
105-
for chunk in interpreter.chat(message, display=False, stream=True):
106-
print(chunk)
107-
```
108-
10997
### Interactive Chat
11098

11199
To start an interactive chat in your terminal, either run `interpreter` from the command line:
@@ -197,9 +185,9 @@ interpreter.llm.model = "gpt-3.5-turbo"
197185

198186
#### Terminal
199187

200-
Open Interpreter can use OpenAI-compatible server to run models locally. (LM Studio, jan.ai, ollama etc)
188+
Open Interpreter can use OpenAI-compatible server to run models locally (in LM Studio, Jan.ai, Ollama, etc.)
201189

202-
Simply run `interpreter` with the api_base URL of your inference server (for LM studio it is `http://localhost:1234/v1` by default):
190+
Simply run `interpreter` with the `api_base` URL of your inference server (for LM Studio it is `http://localhost:1234/v1` by default):
203191

204192
```shell
205193
interpreter --api_base "http://localhost:1234/v1" --api_key "fake_key"
@@ -211,11 +199,11 @@ Alternatively you can use Llamafile without installing any third party software
211199
interpreter --local
212200
```
213201

214-
for a more detailed guide check out [this video by Mike Bird](https://www.youtube.com/watch?v=CEs51hGWuGU?si=cN7f6QhfT4edfG5H)
202+
for a more detailed guide check out [this video by Mike Bird](https://www.youtube.com/watch?v=CEs51hGWuGU&si=cN7f6QhfT4edfG5H)
215203

216204
**How to run LM Studio in the background.**
217205

218-
1. Download [https://lmstudio.ai/](https://lmstudio.ai/) then start it.
206+
1. Download [LM Studio](https://lmstudio.ai/) then start it.
219207
2. Select a model then click **↓ Download**.
220208
3. Click the **↔️** button on the left (below 💬).
221209
4. Select your model at the top, then click **Start Server**.
@@ -351,11 +339,11 @@ There is **experimental** support for a [safe mode](https://github.com/OpenInter
351339

352340
## How Does it Work?
353341

354-
Open Interpreter equips a [function-calling language model](https://platform.openai.com/docs/guides/gpt/function-calling) with an `exec()` function, which accepts a `language` (like "Python" or "JavaScript") and `code` to run.
342+
Open Interpreter equips a [function-calling language model](https://platform.openai.com/docs/guides/function-calling) with an `exec()` function, which accepts a `language` (like "Python" or "JavaScript") and `code` to run.
355343

356344
We then stream the model's messages, code, and your system's outputs to the terminal as Markdown.
357345

358-
# Access Documentation Offline
346+
## Access Documentation Offline
359347

360348
The full [documentation](https://docs.openinterpreter.com/) is accessible on-the-go without the need for an internet connection.
361349

@@ -383,13 +371,13 @@ mintlify dev
383371

384372
A new browser window should open. The documentation will be available at [http://localhost:3000](http://localhost:3000) as long as the documentation server is running.
385373

386-
# Contributing
374+
## Contributing
387375

388376
Thank you for your interest in contributing! We welcome involvement from the community.
389377

390378
Please see our [contributing guidelines](https://github.com/OpenInterpreter/open-interpreter/blob/main/docs/CONTRIBUTING.md) for more details on how to get involved.
391379

392-
# Roadmap
380+
## Roadmap
393381

394382
Visit [our roadmap](https://github.com/OpenInterpreter/open-interpreter/blob/main/docs/ROADMAP.md) to preview the future of Open Interpreter.
395383

@@ -400,5 +388,3 @@ Visit [our roadmap](https://github.com/OpenInterpreter/open-interpreter/blob/mai
400388
> Having access to a junior programmer working at the speed of your fingertips ... can make new workflows effortless and efficient, as well as open the benefits of programming to new audiences.
401389
>
402390
> _OpenAI's Code Interpreter Release_
403-
404-
<br>

0 commit comments

Comments
 (0)