From a7f381cb365940b09d458547ca3821ff5140491f Mon Sep 17 00:00:00 2001
From: killian <63927363+KillianLucas@users.noreply.github.com>
Date: Sun, 25 Aug 2024 17:06:58 -0700
Subject: [PATCH] 01.1
---
CONTEXT.md | 4 +-
CONTRIBUTING.md | 49 +-
GOALS.md | 21 -
INSPIRATION.md | 7 -
README.md | 30 +-
ROADMAP.md | 11 +-
TASKS.md | 92 --
TEAMS.md | 69 -
USE_CASES.md => USES.md | 0
docs/README.md | 4 +-
docs/snippets/snippet-intro.mdx | 4 -
hardware/light/wiring-diagram.jpg | Bin 285078 -> 0 bytes
... Wiring Diagram.png => wiring-diagram.png} | Bin
project_management/communication/TEAM.md | 3 -
.../communication/press/TEAM.md | 3 -
project_management/experience/TEAM.md | 7 -
project_management/experience/design/TASKS.md | 5 -
.../experience/research/TASKS.md | 1 -
.../experience/research/TEAM.md | 2 -
.../experience/video_and_brand/TEAM.md | 4 -
project_management/hardware/OPTIONS.md | 33 -
project_management/hardware/TASKS.md | 9 -
project_management/hardware/TEAM.md | 7 -
.../hardware/devices/jetson-nano/README.md | 22 -
.../jetson-nano/mac-share-internet-v2.png | Bin 480938 -> 0 bytes
.../jetson-nano/mac-share-internet.png | Bin 719309 -> 0 bytes
.../hardware/devices/raspberry-pi/README.md | 79 --
.../devices/raspberry-pi/button-diagram.png | Bin 1046848 -> 0 bytes
project_management/meetups/01-20-24.md | 20 -
project_management/software/audio/TASKS.md | 3 -
project_management/software/audio/TEAM.md | 5 -
project_management/software/oi_core/TASKS.md | 3 -
project_management/software/oi_core/TEAM.md | 8 -
project_management/software/os/TASKS.md | 13 -
project_management/software/os/TEAM.md | 5 -
run_pytest.py | 36 -
software/.cursorignore | 3 -
software/{start.py => main.py} | 17 +-
software/poetry.lock | 1201 ++++++-----------
software/pyproject.toml | 50 +-
software/pytest.ini | 10 -
.../source/clients/archive_base_device.py | 482 -------
software/source/clients/base_device.py | 99 --
software/source/clients/esp32/README.md | 28 -
.../source/clients/light-python/client.py | 9 +-
.../beeps.py => light-python/macos_beeps.py} | 0
software/source/clients/linux/__init__.py | 0
software/source/clients/linux/device.py | 13 -
software/source/clients/mac/__init__.py | 0
software/source/clients/mac/device.py | 14 -
.../source/clients/{ => mobile}/ios/README.md | 0
.../zeroone-app.xcodeproj/project.pbxproj | 0
.../contents.xcworkspacedata | 0
.../xcshareddata/IDEWorkspaceChecks.plist | 0
.../xcshareddata/WorkspaceSettings.xcsettings | 0
.../UserInterfaceState.xcuserstate | Bin
.../WorkspaceSettings.xcsettings | 0
.../zeroone-app/zeroone-app/AppDelegate.swift | 0
.../AccentColor.colorset/Contents.json | 0
.../AppIcon.appiconset/Contents.json | 0
.../Assets.xcassets/AppIcon.appiconset/O.png | Bin
.../zeroone-app/Assets.xcassets/Contents.json | 0
.../vector.imageset/Contents.json | 0
.../vector.imageset/vector.svg | 0
.../zeroone-app/AudioRecording.swift | 0
.../Base.lproj/LaunchScreen.storyboard | 0
.../zeroone-app/Base.lproj/Main.storyboard | 0
.../ios/zeroone-app/zeroone-app/Info.plist | 0
.../zeroone-app/SceneDelegate.swift | 0
.../zeroone-app/ViewController.swift | 0
software/source/clients/rpi/__init__.py | 0
software/source/clients/rpi/device.py | 11 -
software/source/clients/windows/__init__.py | 0
software/source/clients/windows/device.py | 13 -
.../server/archive_async_interpreter.py | 252 ----
.../source/server/archive_async_server.py | 124 --
software/source/server/conftest.py | 36 -
.../conversations/another-interpreter.json | 0
.../{ => source/server/livekit}/worker.py | 0
.../server/{async_server.py => server.py} | 46 +-
software/source/server/skills/__init__.py | 0
.../system_messages/BaseSystemMessage.py | 242 ----
.../system_messages/TeachModeSystemMessage.py | 136 --
.../source/server/system_messages/__init__.py | 0
software/source/server/tests/test_run.py | 4 +-
software/source/server/tunnel.py | 30 -
software/source/server/utils/bytes_to_wav.py | 67 -
software/source/server/utils/logs.py | 24 -
software/source/server/utils/process_utils.py | 33 -
software/source/utils/accumulator.py | 93 --
software/source/utils/print_markdown.py | 10 -
software/tests/__init__.py | 0
92 files changed, 502 insertions(+), 3104 deletions(-)
delete mode 100644 GOALS.md
delete mode 100644 INSPIRATION.md
delete mode 100644 TASKS.md
delete mode 100644 TEAMS.md
rename USE_CASES.md => USES.md (100%)
delete mode 100644 docs/snippets/snippet-intro.mdx
delete mode 100644 hardware/light/wiring-diagram.jpg
rename hardware/light/{Labeled Wiring Diagram.png => wiring-diagram.png} (100%)
delete mode 100644 project_management/communication/TEAM.md
delete mode 100644 project_management/communication/press/TEAM.md
delete mode 100644 project_management/experience/TEAM.md
delete mode 100644 project_management/experience/design/TASKS.md
delete mode 100644 project_management/experience/research/TASKS.md
delete mode 100644 project_management/experience/research/TEAM.md
delete mode 100644 project_management/experience/video_and_brand/TEAM.md
delete mode 100644 project_management/hardware/OPTIONS.md
delete mode 100644 project_management/hardware/TASKS.md
delete mode 100644 project_management/hardware/TEAM.md
delete mode 100644 project_management/hardware/devices/jetson-nano/README.md
delete mode 100644 project_management/hardware/devices/jetson-nano/mac-share-internet-v2.png
delete mode 100644 project_management/hardware/devices/jetson-nano/mac-share-internet.png
delete mode 100644 project_management/hardware/devices/raspberry-pi/README.md
delete mode 100644 project_management/hardware/devices/raspberry-pi/button-diagram.png
delete mode 100644 project_management/meetups/01-20-24.md
delete mode 100644 project_management/software/audio/TASKS.md
delete mode 100644 project_management/software/audio/TEAM.md
delete mode 100644 project_management/software/oi_core/TASKS.md
delete mode 100644 project_management/software/oi_core/TEAM.md
delete mode 100644 project_management/software/os/TASKS.md
delete mode 100644 project_management/software/os/TEAM.md
delete mode 100644 run_pytest.py
delete mode 100644 software/.cursorignore
rename software/{start.py => main.py} (91%)
delete mode 100644 software/pytest.ini
delete mode 100644 software/source/clients/archive_base_device.py
delete mode 100644 software/source/clients/base_device.py
delete mode 100644 software/source/clients/esp32/README.md
rename software/source/clients/{mac/beeps.py => light-python/macos_beeps.py} (100%)
delete mode 100644 software/source/clients/linux/__init__.py
delete mode 100644 software/source/clients/linux/device.py
delete mode 100644 software/source/clients/mac/__init__.py
delete mode 100644 software/source/clients/mac/device.py
rename software/source/clients/{ => mobile}/ios/README.md (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app.xcodeproj/project.pbxproj (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app.xcodeproj/project.xcworkspace/contents.xcworkspacedata (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app.xcodeproj/project.xcworkspace/xcuserdata/eladdekel.xcuserdatad/UserInterfaceState.xcuserstate (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app.xcodeproj/project.xcworkspace/xcuserdata/eladdekel.xcuserdatad/WorkspaceSettings.xcsettings (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/AppDelegate.swift (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Assets.xcassets/AccentColor.colorset/Contents.json (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Assets.xcassets/AppIcon.appiconset/Contents.json (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Assets.xcassets/AppIcon.appiconset/O.png (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Assets.xcassets/Contents.json (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Assets.xcassets/vector.imageset/Contents.json (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Assets.xcassets/vector.imageset/vector.svg (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/AudioRecording.swift (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Base.lproj/LaunchScreen.storyboard (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Base.lproj/Main.storyboard (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/Info.plist (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/SceneDelegate.swift (100%)
rename software/source/clients/{ => mobile}/ios/zeroone-app/zeroone-app/ViewController.swift (100%)
delete mode 100644 software/source/clients/rpi/__init__.py
delete mode 100644 software/source/clients/rpi/device.py
delete mode 100644 software/source/clients/windows/__init__.py
delete mode 100644 software/source/clients/windows/device.py
delete mode 100644 software/source/server/archive_async_interpreter.py
delete mode 100644 software/source/server/archive_async_server.py
delete mode 100644 software/source/server/conftest.py
delete mode 100644 software/source/server/conversations/another-interpreter.json
rename software/{ => source/server/livekit}/worker.py (100%)
rename software/source/server/{async_server.py => server.py} (82%)
delete mode 100644 software/source/server/skills/__init__.py
delete mode 100644 software/source/server/system_messages/BaseSystemMessage.py
delete mode 100644 software/source/server/system_messages/TeachModeSystemMessage.py
delete mode 100644 software/source/server/system_messages/__init__.py
delete mode 100644 software/source/server/tunnel.py
delete mode 100644 software/source/server/utils/bytes_to_wav.py
delete mode 100644 software/source/server/utils/logs.py
delete mode 100644 software/source/server/utils/process_utils.py
delete mode 100644 software/source/utils/accumulator.py
delete mode 100644 software/source/utils/print_markdown.py
delete mode 100644 software/tests/__init__.py
diff --git a/CONTEXT.md b/CONTEXT.md
index 7b53070..7fa9640 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -1,4 +1,4 @@
-# Takeaways
+# Context
1. **Be minimal.**
@@ -6,7 +6,7 @@ Both to developers (the 01 should be very programmer friendly) and to the end us
2. **Develop standards.**
-That should be compatible with other popular systems. For example, I think [LMC messages](https://docs.openinterpreter.com/protocols/lmc-messages) should ~ work on OpenAI's API and vice versa.
+That should be compatible with other popular systems.
3. **Resonate strongly with a niche.**
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 61c1171..40500e8 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,21 +1,13 @@
# ●
-**01 is the world's first open-source Language Model Computer (LMC). 01OS is the operating system that powers it**
-
There are many ways to contribute, from helping others on [Github](https://github.com/KillianLucas/01/issues) or [Discord](https://discord.gg/Hvz9Axh84z), writing documentation, or improving code.
-We depend on contributors like you. Let's build this.
-
## What should I work on?
-Please pick up a task from our [roadmap](https://github.com/KillianLucas/01/blob/main/ROADMAP.md) or work on solving an [issue](https://github.com/KillianLucas/01/issues).
+Please pick up a task from [issues](https://github.com/KillianLucas/01/issues).
If you encounter a bug or have a feature in mind, [search if an issue already exists](https://docs.github.com/en/github/searching-for-information-on-github/searching-on-github/searching-issues-and-pull-requests#search-by-the-title-body-or-comments). If a related issue doesn't exist, please [open a new issue](https://github.com/KillianLucas/01/issues/new/choose).
-## Philosophy
-
-01OS embodies a philosophy of breaking free from technological limitations and knowledge gaps by leveraging AI for intuitive, natural language interactions, democratizing access to compute through open-source flexibility and transforming devices into responsive, human-centric computing tools.
-
# Contribution Guidelines
1. Before taking on significant code changes, please discuss your ideas on [Discord](https://discord.gg/Hvz9Axh84z) to ensure they align with our vision. We want to keep the codebase simple and unintimidating for new users.
@@ -31,31 +23,13 @@ We will review PRs when possible and work with you to integrate your contributio
Once you've forked the code and created a new branch for your work, you can run the fork by following these steps:
-1. CD into the project folder `/01OS`
+1. CD into the software folder `/software`
2. Install dependencies `poetry install`
3. Run the program `poetry run 01`
-**Note**: This project uses [`black`](https://black.readthedocs.io/en/stable/index.html) and [`isort`](https://pypi.org/project/isort/) via a [`pre-commit`](https://pre-commit.com/) hook to ensure consistent code style. If you need to bypass it for some reason, you can `git commit` with the `--no-verify` flag.
-
-### Installing New Dependencies
-
-If you wish to install new dependencies into the project, please use `poetry add package-name`.
-
-### Installing Developer Dependencies
-
-If you need to install dependencies specific to development, like testing tools, formatting tools, etc. please use `poetry add package-name --group dev`.
-
-### Known Issues
-
-For some, `poetry install` might hang on some dependencies. As a first step, try to run the following command in your terminal:
-
-`export PYTHON_KEYRING_BACKEND=keyring.backends.fail.Keyring`
-
-Then run `poetry install` again. If this doesn't work, please join our [Discord community](https://discord.gg/Hvz9Axh84z) for help.
-
## Code Formatting and Linting
-Our project uses `black` for code formatting and `isort` for import sorting. To ensure consistency across contributions, please adhere to the following guidelines:
+Our project uses [`black`](https://black.readthedocs.io/en/stable/index.html) for code formatting and [`isort`](https://pypi.org/project/isort/) for import sorting via a [`pre-commit`](https://pre-commit.com/) hook to ensure consistent code style across contributions. Please adhere to the following guidelines:
1. **Install Pre-commit Hooks**:
@@ -63,7 +37,6 @@ Our project uses `black` for code formatting and `isort` for import sorting. To
```bash
cd software # Change into `software` directory if not there already.
- poetry shell # It's better to do it within the virtual environment of your project
poetry add --dev pre-commit # Install pre-commit as a dev dependency
pre-commit install
```
@@ -79,6 +52,22 @@ Our project uses `black` for code formatting and `isort` for import sorting. To
isort .
```
+3. **Bypassing**:
+
+ If you need to bypass this for some reason, you can `git commit` with the `--no-verify` flag.
+
+### Installing New Dependencies
+
+If you wish to install new dependencies into the project, please use `poetry add package-name`.
+
+### Known Issues
+
+For some, `poetry install` might hang on some dependencies. As a first step, try to run the following command in your terminal:
+
+`export PYTHON_KEYRING_BACKEND=keyring.backends.fail.Keyring`
+
+Then run `poetry install` again. If this doesn't work, please join our [Discord community](https://discord.gg/Hvz9Axh84z) for help.
+
# Licensing
Contributions to 01 are under AGPL.
diff --git a/GOALS.md b/GOALS.md
deleted file mode 100644
index a3f58ba..0000000
--- a/GOALS.md
+++ /dev/null
@@ -1,21 +0,0 @@
-**The 01 Project** is comprised of the following goals, to be completed by _February 23rd, 2024_:
-
-
-
-# 1. Create a blueprint
-We will create a blueprint for a LMC (Language Model Computer) called the 01.
-
-
-
-# 2. Publish a family of protocols
-We will publish protocols to advance the LMC ecosystem.
-
-
-
-# 3. Film a compelling video
-This video will showcase the 01.
-
-
-
-# 4. Build a physical device
-Everyone on the core team will receive a functional device.
diff --git a/INSPIRATION.md b/INSPIRATION.md
deleted file mode 100644
index da1aa2a..0000000
--- a/INSPIRATION.md
+++ /dev/null
@@ -1,7 +0,0 @@
-| | |
-|---|---|
-|  |  |
-|  |  |
-|  |  |
-|  |  |
-|  | |
diff --git a/README.md b/README.md
index 378e9f7..59e0b36 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
- The open-source language model computer.
+ The #1 open-source voice interface.
Get Updates | Documentation
@@ -26,14 +26,20 @@ We want to help you build. [Apply for 1-on-1 support.](https://0ggfznkwh4j.typef
> [!IMPORTANT]
> This experimental project is under rapid development and lacks basic safeguards. Until a stable `1.0` release, only run this repository on devices without sensitive information or access to paid services.
->
-> **A substantial rewrite to address these concerns and more, including the addition of [RealtimeTTS](https://github.com/KoljaB/RealtimeTTS) and [RealtimeSTT](https://github.com/KoljaB/RealtimeSTT), is occurring [here](https://github.com/KillianLucas/01-rewrite/tree/main).**
-**The 01 Project** is building an open-source ecosystem for AI devices.
+The **01** is an open-source platform for conversational devices, inspired by the *Star Trek* computer.
-Our flagship operating system can power conversational devices like the Rabbit R1, Humane Pin, or [Star Trek computer](https://www.youtube.com/watch?v=1ZXugicgn6U).
+With [Open Interpreter](https://github.com/OpenInterpreter/open-interpreter) at its core, the **01** is more natural, flexible, and capable than its predecessors. Assistants built on **01** can:
+
+- Execute code
+- Browse the web
+- Read and create files
+- Control third-party software
+- ...
+
+
We intend to become the GNU/Linux of this space by staying open, modular, and free.
@@ -59,7 +65,7 @@ poetry run 01 # Runs the 01 Light simulator (hold your spacebar, speak, release)
-**The [RealtimeTTS](https://github.com/KoljaB/RealtimeTTS) and [RealtimeSTT](https://github.com/KoljaB/RealtimeSTT) libraries in the incoming 01-rewrite are thanks to the state-of-the-art voice interface work of [Kolja Beigel](https://github.com/KoljaB). Please star those repos and consider contributing to / utilizing those projects!**
+**Note:** The [RealtimeTTS](https://github.com/KoljaB/RealtimeTTS) and [RealtimeSTT](https://github.com/KoljaB/RealtimeSTT) libraries at the heart of the 01 are thanks to the voice interface work of [Kolja Beigel](https://github.com/KoljaB). Please star those repos and consider contributing to / utilizing those projects.
# Hardware
@@ -73,7 +79,7 @@ poetry run 01 # Runs the 01 Light simulator (hold your spacebar, speak, release)
# What does it do?
-The 01 exposes a speech-to-speech websocket at `localhost:10001`.
+The 01 exposes a speech-to-speech websocket at `localhost:10101`.
If you stream raw audio bytes to `/` in [Streaming LMC format](https://docs.openinterpreter.com/guides/streaming-response), you will receive its response in the same format.
@@ -112,7 +118,7 @@ To run the server on your Desktop and connect it to your 01 Light, run the follo
```shell
brew install ngrok/ngrok/ngrok
ngrok authtoken ... # Use your ngrok authtoken
-poetry run 01 --server --expose
+poetry run 01 --server light --expose
```
The final command will print a server URL. You can enter this into your 01 Light's captive WiFi portal to connect to your 01 Server.
@@ -120,11 +126,9 @@ The final command will print a server URL. You can enter this into your 01 Light
## Local Mode
```
-poetry run 01 --local
+poetry run 01 --profile local.py
```
-If you want to run local speech-to-text using Whisper, you must install Rust. Follow the instructions given [here](https://www.rust-lang.org/tools/install).
-
## Customizations
To customize the behavior of the system, edit the [system message, model, skills library path,](https://docs.openinterpreter.com/settings/all-settings) etc. in the `profiles` directory under the `server` directory. This file sets up an interpreter, and is powered by Open Interpreter.
@@ -157,10 +161,6 @@ Visit [our roadmap](/ROADMAP.md) to see the future of the 01.
The story of devices that came before the 01.
-### [Inspiration ↗](https://github.com/KillianLucas/01/tree/main/INSPIRATION.md)
-
-Things we want to steal great ideas from.
-
○
diff --git a/ROADMAP.md b/ROADMAP.md
index 58938b3..f16124d 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -1,12 +1,13 @@
# Roadmap
-Our goal is to power a billion devices with the 01OS over the next 10 years. The Cambrian explosion of AI devices.
+Our goal is to power a billion devices with the 01's software over the next 10 years.
-We can do that with your help. Help extend the 01OS to run on new hardware, to connect with new peripherals like GPS and cameras, and add new locally running language models to unlock use-cases for this technology that no-one has even imagined yet.
+We can do that with your help. Help extend the 01 to run on new hardware, to connect with new peripherals like GPS and cameras, and to add new locally running language models to unlock use-cases for this technology that no-one has imagined.
In the coming months, we're going to release:
-- [ ] Add support for Azure and PlayHT for fast latency
-- [ ] An open-source language model for computer control
- [ ] A react-native app for your phone
-- [ ] A hand-held device that runs fully offline.
+- [ ] Speech-to-speech model support (like `gpt-4o`) instead of TTS/STT
+ - [ ] Implement `Ultravox`
+- [ ] An open-source language model for computer control
+- [ ] A hand-held device that runs fully offline.
\ No newline at end of file
diff --git a/TASKS.md b/TASKS.md
deleted file mode 100644
index 946e214..0000000
--- a/TASKS.md
+++ /dev/null
@@ -1,92 +0,0 @@
-**OI**
-
-- [ ] Finish skill library.
- - [ ] Create a system message that includes instructions on how to use the skill library.
- - [ ] Test it end-to-end.
- - [ ] Make sure it works with computer.skills.search (it should already work)
- - [ ] Create computer.skills.teach()
- - [ ] Displays a tkinter message asking users to complete the task via text (eventually voice) in the most generalizable way possible. OI should use computer.mouse and computer.keyboard to fulfill each step, then save the generalized instruction as a skill. Clicking the mouse cancels teach mode. When OI invokes this skill in the future, it will just list those steps (it needs to figure out how to flexibly accomplish each step).
- - [ ] Computer: "What do you want to name this skill?"
- - [ ] User: Enters name in textbox
- - [ ] Computer: "Whats the First Step"
- - [ ] User: textbox appears types instructions
- - [ ] Textbox disappears
- - [ ] OI follows instruction
- - [ ] "Did that work?" Yes/No?
- - [ ] If No: repeat step training
- - [ ] Computer: "Great! What's the next step?" ....
- - [ ] Repeat until all steps of skill are completed
- - [ ] Save skill as a function next() steps through user's steps
- - [ ] Expose ^ via `01 --teach`.
-- [ ] pip install 01
- - [ ] Add `01 --server --expose`.
- - [ ] Add --server --expose which will expose the server via something like Ngrok, display the public URL and a password, so the 01 Light can connect to it. This will let people use OI on their computer via their Light — i.e. "Check my emails" will run Applescript on their home computer.
-- [ ] Sync Interpreter/Computer between code blocks
-- [ ] New default dynamic system message with computer API + skills.
- - [ ] Develop default system message for executive assistant.
- - [ ] Better local system message
-- [ ] write good docstrings for computer API
-- [ ] Inject computer API into python routine
-- [ ] determine streaming LMC protocol
- - [ ] inlcude headers?
-- [ ] Why is OI starting so slowly? We could use time.time() around things to track it down.
-- [ ] Create moondream-powered computer.camera.
- - [ ] Computer.camera.view(query) should take a picture and ask moondream the query. Defaults to "Describe this image in detail."
- - [ ] Takes Picture
- - [ ] Sends to describe API
- - [ ] prints and returns description
- - [ ] Llamafile for phi-2 + moondream
- - [ ] test on rPi + Jetson (+android mini phone?)
-
-**OS**
-
-- [ ] Queue speech results
- - [ ] TTS sentences should be queued + playback should stop once button is pressed
-- [ ] expose server using Ngrok
-- [ ] Swap out the current hosted functions for local ones.
- - [ ] TTS — Piper? OpenVoice? Rasspy?
- - [ ] STT — Whisper? Canary?
- - [ ] LLM — Phi-2 Q4 Llamafile, just need to download it, OI knows how to use Llamafiles
-- [ ] Functional Requirements
- - [ ] for initial user setup and first experience
- - [ ] If Light and no internet, open a captive wifi page with text boxes: Wifi Name, Wifi Pass, (optional) Server URL, (optional) Server Pass
- - [ ] in device.py
-- [ ] Camera input from user in device.py
-- [ ] Can tapping the mic twice = trigger pressing the "button"? Simple sensing, just based on volume spikes?
-- [ ] Update Architecture
- - [ ] Base Devise Class
- - [ ] Separate folders for Rasberry Pi, Desktop, Droid, App, Web
- - [ ] device.py for each folder has input logic for that device
- - [ ] Add basic TUI to device.py. Just renders messages and lets you add messages. Can easily copy OI's TUI.
- - [ ] index.html for each folder has user interface for that device
- - [ ] Web is just index.html
- - [ ] Display.html? gui.html?
-- [ ] Replace bootloader and boot script— should just run 01, full screen TUI.
-- [ ] Package it as an ISO, or figure out some other simple install instructions. How to easily install on a Pi?
-
-**Hardware**
-
-- [ ] (Hardware and software) Get the 01OS working on the **Jetson** or Pi. Pick one to move forward with.
-- [ ] Connect the Seeed Sense (ESP32 with Wifi, Bluetooth and a mic) to a small DAC + amplifier + speaker.
-- [ ] Connect the Seeed Sense to a battery.
-- [ ] Configure the ESP32 to be a wireless mic + speaker for the Jetson or Pi.
-- [ ] Connect the Jetson or Pi to a battery.
-- [ ] Make a rudimentary case for the Seeed Sense + speaker. Optional.
-- [ ] Make a rudimentary case for the Jetson or Pi. Optional.
-
-**Release Day**
-
-- [ ] Launch video "cambriah explosion" 3d Sketch
-- [ ] Create form to get pre-release feedback from 200 interested people (who responded to Killian's tweet)
-
-**DONE**
-
-- [ ] Get Local TTS working on Mac [Shiven]
-- [ ] Get Local SST working on Mac [Zohaib + Shiven]
-- [ ] Debug level logging/printing [Tom]
-- [ ] Get hardware (mic, speaker, button) working on the rPi (running on battery) [Ty]
-- [ ] device.py conditionals for platform [Ty]
-- [ ] Kernal filtering issues [Tom]
-- [ ] .env file [Tom]
-- [ ] Save computer messages in User.json [Kristijan]
-- [ ] Service Management [Zach]
diff --git a/TEAMS.md b/TEAMS.md
deleted file mode 100644
index af0ddb9..0000000
--- a/TEAMS.md
+++ /dev/null
@@ -1,69 +0,0 @@
-# Teams
-
-## Hardware
-
-- Ben @humanbee
-- Ty @tyisfly
-- Use Michael as a recruitor
-- Shiven @shivenmian
-- Jacob Weisel
-- Aniket @atneik
-- ..?
-
-## Software
-
-- Audio (TTS / SST)
- - Tasks: Streaming audio both ways.
- - Hardware limitations. What's the smallest hardware this can be on?
- - Zach @zwf
- - Zohaib @Zabirauf
- - Atai @atai_copilotkit
-- OI Core
- - Tasks: Computer API (schedule thing), skill library
- - Hristijan @thekeyq
- - Aakash @ashgam.\_
- - Aniket @atneik
- - Shiven @shivenmian
- - Ty @tyisfly
- - Killian @killianlucas
-- OS (formerly 'Linux / Firmware`)
- - Tasks: Virtualization? ISO? Putting sensors around the OS to put files into the queue. Bootloader. Networked input into the queue
- - Shiven @shivenmian
- - Hristijan @thekeyq
- - Michael @mjjt
- - Zohaib @Zabirauf
-
-## Experience
-
-- Design
- - Arturo @arturot
- - Ronith @ronithk
- - Danny @dannytayara
- - Killian @killianlucas
- - Aniket @atneik
- - Alim
- - Eschwa?
- - Industrial
- - Interface
- - Web
- - Brand / Video
- - Arturo @arturot
- - Killian @killianlucas
- - Matt @matt_rygh
- - Finn
-- Research
- - Ben @humanbee
- - Use-cases
- - Tasks: Send out typeform—what are motivating examples?
- - Testing
- - Uli @ulidabess
-
-## Comms
-
-- Uli @ulidabess
-- Discord Community
-- Twitter Presence
- - Killian @killianlucas
-- Press
- - Michael @mjjt
- - Zach (connection at NYT) @zwf
diff --git a/USE_CASES.md b/USES.md
similarity index 100%
rename from USE_CASES.md
rename to USES.md
diff --git a/docs/README.md b/docs/README.md
index 7e065b0..1543777 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,6 +1,4 @@
-# 01OS
-
-## Contribute
+## Contribute to these docs
- Clone this repo
- install mintlify CLI
- run mintlify in project directory to get preview of docs
diff --git a/docs/snippets/snippet-intro.mdx b/docs/snippets/snippet-intro.mdx
deleted file mode 100644
index c57e7c7..0000000
--- a/docs/snippets/snippet-intro.mdx
+++ /dev/null
@@ -1,4 +0,0 @@
-One of the core principles of software development is DRY (Don't Repeat
-Yourself). This is a principle that apply to documentation as
-well. If you find yourself repeating the same content in multiple places, you
-should consider creating a custom snippet to keep your content in sync.
diff --git a/hardware/light/wiring-diagram.jpg b/hardware/light/wiring-diagram.jpg
deleted file mode 100644
index 781928956dba70b9526551abeb05b4f0dc0e50c5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 285078
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