OpenVibe

Local-first AI coding teaching platform. Run a web workspace on your machine, chat with the agent in the browser, and learn by building real projects.

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/syy-shark/openvibe/master/install.sh | bash

All platforms with npm:

npm install -g openvibe.ai

Windows: use npm install -g openvibe.ai in PowerShell or Command Prompt. curl | bash is intended for macOS / Linux, or Windows users running WSL.

Start

openvibe

By default OpenVibe starts a local web server on http://127.0.0.1:4242 and opens the browser automatically.

Platform Support

• macOS: supported
• Linux: supported
• Windows: supported with Node.js 18+ and npm

Notes:

• The published app can run on all three platforms.
• The curl | bash installer is for Unix-like shells, so native Windows should use npm directly.
• The Playwright-powered browser tool may need extra browser/system dependencies on some Linux machines.

Environment Variables

export OPENVIBE_PORT=4242
export OPENVIBE_HOST=127.0.0.1
export OPENVIBE_NO_OPEN=1

User Data

• Global config: ~/.openvibe/config.toml
• Project registry: ~/.openvibe/projects.json
• Project workspaces: ~/.openvibe/projects/
• Copilot auth: ~/.openvibe/copilot-auth.json
• Codex auth: ~/.openvibe/codex-auth.json
• Skills: ~/.openvibe/skills/

Project-specific instructions can live in any of these files:

• .openvibe.md
• .openvibe/instructions.md
• OPENVIBE.md

What OpenVibe Provides

• React + Vite + Tailwind web UI
• Hono backend with SSE streaming
• Split workspace with chat, file tree, module graph, preview, and logs
• Built-in teaching cards for concepts, tips, and next steps
• Local project templates for web, mobile, desktop, and agent workflows
• Reuse of the existing provider, tool, and agent runtime

Providers

OpenVibe supports these providers:

• deepseek
• ark
• openai
• openrouter
• siliconflow
• groq
• together
• qwen
• ollama
• custom
• copilot
• codex

Provider settings are managed from the in-app Settings page and stored in ~/.openvibe/config.toml.

Run From Source

git clone https://github.com/syy-shark/openvibe.git
cd openvibe
bun install
bun run build
node dist/server.mjs

Build

bun run build

This builds:

• dist/server.mjs
• web/dist/

License

MIT