autopreso 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AutoPreso contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+<h1 align="center">autopreso</h1>
+
+<p align="center">
+  <a href="https://github.com/kunchenguid/autopreso/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/kunchenguid/autopreso/ci.yml?style=flat-square&label=ci" /></a>
+  <a href="https://github.com/kunchenguid/autopreso/actions/workflows/release-please.yml"><img alt="Release" src="https://img.shields.io/github/actions/workflow/status/kunchenguid/autopreso/release-please.yml?style=flat-square&label=release" /></a>
+  <a href="https://www.npmjs.com/package/autopreso"><img alt="npm" src="https://img.shields.io/npm/v/autopreso?style=flat-square" /></a>
+  <a href="https://img.shields.io/badge/platform-macOS-blue?style=flat-square"><img alt="Platform" src="https://img.shields.io/badge/platform-macOS-blue?style=flat-square" /></a>
+  <a href="https://x.com/kunchenguid"><img alt="X" src="https://img.shields.io/badge/X-@kunchenguid-black?style=flat-square" /></a>
+  <a href="https://discord.gg/Wsy2NpnZDu"><img alt="Discord" src="https://img.shields.io/discord/1439901831038763092?style=flat-square&label=discord" /></a>
+</p>
+
+<h3 align="center">Let the whiteboard whiteboard itself.</h3>
+
+> [!WARNING]
+> autopreso is in **alpha** and under active development. Expect rough edges, breaking changes, and the occasional weird drawing. Bug reports welcome.
+
+You wanted to give the talk, not build the deck.
+
+autopreso runs a local web app with a live Excalidraw canvas and a listening agent.
+You speak; transcripts stream to a model; the model draws, labels, and rearranges the whiteboard in real time.
+Stage a few seed elements, hit start, and present.
+
+- **Hands free** - your speech drives an agent that edits an Excalidraw scene as you talk, no clicking required.
+- **Bring your own model** - use your OpenAI API key or Codex subscription. Auto Preso itself is completely free and open source.
+- **Can run locally** - use Moonshine for transcription and Ollama for the agent and you get a fully local setup.
+
+## Quick Start
+
+```sh
+$ npx autopreso              # boots the server, opens the browser
+autopreso listening at http://127.0.0.1:3210
+whiteboard agent: openai gpt-5.5
+settings file: /Users/you/.config/autopreso/settings.json
+
+# In the browser:
+# 1. Drop reference materials onto the staging canvas (title, agenda, etc).
+# 2. Pick your microphone, pick a transcription model and an agent model.
+# 3. Click "Start preso" and start talking.
+```
+
+## Install
+
+**npm (recommended)**
+
+```sh
+npm install -g autopreso
+autopreso
+```
+
+**npx (no install)**
+
+```sh
+npx autopreso
+```
+
+**From source**
+
+```sh
+git clone https://github.com/kunchenguid/autopreso.git
+cd autopreso
+npm install
+npm start
+```
+
+## How It Works
+
+```
+  ┌──────────┐   audio    ┌──────────────┐   text   ┌──────────────┐
+  │   mic    │──────────► │     STT      │────────► │  whiteboard  │
+  │ (browser)│   24kHz    │ Moonshine /  │ chunks   │    agent     │
+  └──────────┘            │ OpenAI WS    │          │ (OpenAI /    │
+                          └──────────────┘          │  Codex /     │
+                                                    │  Ollama)     │
+                                                    └──────┬───────┘
+                                                           │ tool calls
+                                                           ▼
+                                                  ┌────────────────┐
+                                                  │   Excalidraw   │
+                                                  │  scene (live)  │
+                                                  └────────────────┘
+```
+
+- **Two modes** - "staging" lets you sketch seed content client-side; "live" hands the canvas over to the agent and starts streaming transcripts.
+- **Local server, local network only** - the Express + WebSocket server binds to 127.0.0.1; nothing is exposed beyond your machine.
+- **Persistent settings** - models, API keys, and STT engine choices live in `~/.config/autopreso/settings.json` and survive restarts.
+- **Warmup loop** - after you hit start the agent primes itself against your staging content so the first sentence you say doesn't get a cold model.
+
+## CLI Reference
+
+| Command        | Description                                  |
+| -------------- | -------------------------------------------- |
+| `autopreso`    | Start the local server and open the browser. |
+| `autopreso -h` | Show help.                                   |
+
+### Flags
+
+| Flag         | Description                                   |
+| ------------ | --------------------------------------------- |
+| `--no-open`  | Start the server without opening the browser. |
+| `-h, --help` | Show help.                                    |
+
+## Configuration
+
+Settings persist at `~/.config/autopreso/settings.json` and are managed from the in-app status panel.
+
+### Defaults on first run
+
+When no settings file exists, autopreso picks providers based on what it finds in your environment:
+
+| You have...                                | Agent provider                 | Transcription              |
+| ------------------------------------------ | ------------------------------ | -------------------------- |
+| Nothing                                    | OpenAI `gpt-5.5` (needs a key) | Moonshine `medium` (macOS) |
+| `OPENAI_API_KEY` in env                    | OpenAI `gpt-5.5`               | OpenAI Realtime            |
+| Codex CLI signed in (`~/.codex/auth.json`) | Codex `gpt-5.5`                | Moonshine `medium`         |
+| Codex CLI signed in + `OPENAI_API_KEY`     | Codex `gpt-5.5`                | OpenAI Realtime            |
+| `OLLAMA_MODEL` set                         | Ollama (your model)            | Moonshine `medium`         |
+
+Auto-detection precedence: **Codex CLI auth wins over `OLLAMA_MODEL` wins over `OPENAI_API_KEY`** for the agent. Transcription flips to OpenAI Realtime any time an OpenAI key is present, otherwise Moonshine. After first run, this auto-detection no longer applies - change providers from the in-app status panel.
+
+### Environment variables
+
+These only seed `settings.json` on first run. Once the file exists, they're ignored - edit the file or use the in-app panel.
+
+| Variable         | Purpose                                               |
+| ---------------- | ----------------------------------------------------- |
+| `PORT`           | Port to listen on. Default: `3210`.                   |
+| `OPENAI_API_KEY` | Seeds the OpenAI key for both agent and Realtime STT. |
+| `OPENAI_MODEL`   | Seeds the OpenAI agent model.                         |
+| `CODEX_MODEL`    | Seeds the Codex model.                                |
+| `OLLAMA_MODEL`   | Seeds the Ollama model.                               |
+
+Local Moonshine transcription ships as an optional native sidecar for `darwin-arm64` and `darwin-x64`. On other platforms, choose OpenAI Realtime in the STT panel.
+
+## Credits
+
+- [Excalidraw](https://github.com/excalidraw/excalidraw) - the whiteboard canvas, scene model, and rendering.
+- [Moonshine](https://github.com/usefulsensors/moonshine) by Useful Sensors - the local speech-to-text model that makes the offline path possible.
+- [Vercel AI SDK](https://github.com/vercel/ai) - tool-calling agent loop and provider abstraction.
+
+## Development
+
+```sh
+npm install                       # install deps
+npm run dev                       # run the CLI from source
+npm test                          # node --test
+npm run build:moonshine-sidecars  # build the Python sidecar binaries
+```

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "autopreso",
+  "version": "0.1.1",
+  "description": "Realtime speech to presentation. Let the whiteboard whiteboard itself.",
+  "license": "MIT",
+  "author": "Kun Chen <kun@kunchenguid.com>",
+  "homepage": "https://github.com/kunchenguid/autopreso#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kunchenguid/autopreso.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kunchenguid/autopreso/issues"
+  },
+  "keywords": [
+    "excalidraw",
+    "whiteboard",
+    "presentation",
+    "voice",
+    "speech-to-text",
+    "ai-agent",
+    "moonshine",
+    "openai",
+    "transcription",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "type": "module",
+  "bin": {
+    "autopreso": "src/cli.js"
+  },
+  "files": [
+    "LICENSE",
+    "public/",
+    "src/"
+  ],
+  "scripts": {
+    "build:moonshine-sidecars": "node ./scripts/build-moonshine-sidecars.js",
+    "dev": "node ./src/cli.js",
+    "prepare:release-packages": "node ./scripts/prepare-release-packages.js",
+    "test": "node --test",
+    "start": "node ./src/cli.js"
+  },
+  "dependencies": {
+    "@ai-sdk/openai": "^3.0.63",
+    "ai": "^6.0.176",
+    "express": "^5.2.1",
+    "open": "^11.0.0",
+    "ws": "^8.20.0",
+    "zod": "^4.4.3"
+  },
+  "optionalDependencies": {
+    "@autopreso/moonshine-darwin-arm64": "0.1.1",
+    "@autopreso/moonshine-darwin-x64": "0.1.1"
+  },
+  "devDependencies": {}
+}