Metadata-Version: 2.4
Name: openbase-coder
Version: 0.1.5
Summary: OpenBase Coder CLI with embedded server
Project-URL: Repository, https://github.com/openbase-community/openbase-coder
Project-URL: Issues, https://github.com/openbase-community/openbase-coder/issues
Author-email: Gabe Montague <gabe@openbase.com>
License-Expression: AGPL-3.0-only
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: aiohttp>=3.13.3
Requires-Dist: anthropic==0.107.0
Requires-Dist: anyio>=4.13.0
Requires-Dist: channels>=4.2.0
Requires-Dist: click>=8.2.0
Requires-Dist: cryptography>=43.0.0
Requires-Dist: deepagents==0.6.7
Requires-Dist: distro>=1.9.0
Requires-Dist: django-cors-headers>=4.6.0
Requires-Dist: django-mcp-server
Requires-Dist: django==5.2.6
Requires-Dist: djangorestframework==3.16.1
Requires-Dist: docstring-parser>=0.18.0
Requires-Dist: google-auth>=2.53.0
Requires-Dist: google-genai>=2.8.0
Requires-Dist: gunicorn>=23.0.0
Requires-Dist: httpcore>=1.0.9
Requires-Dist: httpx>=0.28.1
Requires-Dist: jiter>=0.15.0
Requires-Dist: langchain-anthropic==1.4.4
Requires-Dist: langchain-core==1.4.1
Requires-Dist: langchain-google-genai==4.2.4
Requires-Dist: langchain==1.3.2
Requires-Dist: langgraph-sdk==0.3.15
Requires-Dist: langgraph==1.2.2
Requires-Dist: livekit-agents[silero,turn-detector]==1.5.17
Requires-Dist: livekit-api>=1.1.0
Requires-Dist: livekit-plugins-assemblyai==1.5.17
Requires-Dist: livekit-plugins-cartesia==1.5.17
Requires-Dist: livekit-plugins-deepgram==1.5.4
Requires-Dist: livekit-plugins-noise-cancellation>=0.2.5
Requires-Dist: mcp[cli]>=1.25.0
Requires-Dist: multi-workspace>=3.2.2
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pyjwt>=2.9.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: super-agents>=0.1.0
Requires-Dist: uv>=0.9.22
Requires-Dist: uvicorn[standard]>=0.32.0
Requires-Dist: websockets>=16.0
Requires-Dist: whitenoise>=6.8.0
Provides-Extra: dev
Requires-Dist: pyinstaller>=6.9.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.1.1; extra == 'dev'
Requires-Dist: pytest-mock>=3.14.0; extra == 'dev'
Requires-Dist: pytest>=8.3.5; extra == 'dev'
Requires-Dist: ruff>=0.11.10; extra == 'dev'
Description-Content-Type: text/markdown

# Openbase Coder

Openbase Coder is a local voice-coding runtime for working with AI coding
agents from your Mac, browser, and Openbase clients.

The `openbase-coder` command installs and runs the local services that power
Openbase Coder: a Django API, WebSocket endpoints, Codex/Super Agents
coordination, local project and diff APIs, LiveKit voice services, plugin
management, and the bundled web console.

This repository is the main open-source entrypoint for the Openbase Coder
runtime.

## What It Provides

- Local API and WebSocket server for coding sessions, diffs, approvals, reports,
  project metadata, and service status
- Voice-agent runtime built around LiveKit and Codex app-server sessions
- One-command macOS setup for the Openbase workspace, environment file,
  console build, launchd services, and default agent instructions
- Plugin installation and bootstrap commands for extending the local runtime
- Openbase Cloud login support for authenticated client workflows
- A local web console served by the CLI

## Requirements

- macOS for full setup and launchd service management
- Python 3.13+
- Git
- `uv` for the recommended install/setup flow and local development
- Node package tooling for the bundled console build
- `livekit-server` on `PATH` for voice services

## Quick Start

Recommended one-line setup with `uvx`:

```bash
uvx --python 3.13 openbase-coder setup
```

This runs the latest published `openbase-coder` package in an isolated `uv`
tool environment and starts the normal first-time setup flow.

For a persistent command on your `PATH` after setup, install with `uv tool`:

```bash
uv tool install --python 3.13 openbase-coder
openbase-coder setup
```

`pipx` is also supported when you already manage Python tools that way:

```bash
pipx install --python python3.13 openbase-coder
```

Verify a persistent install:

```bash
openbase-coder --version
```

## First-Time Setup

If you already installed the persistent `openbase-coder` command, run:

```bash
openbase-coder setup
```

Setup clones the public Openbase Coder workspace into `~/.openbase/workspace`,
syncs the runtime install set, generates `~/.openbase/.env` if needed, builds
the web console, installs launchd services, and prepares the local Codex home
used by voice sessions.

After setup, check the local runtime:

```bash
uvx --python 3.13 openbase-coder doctor
uvx --python 3.13 openbase-coder services status
```

## Run The Server

For foreground development:

```bash
uvx --python 3.13 openbase-coder server --host 0.0.0.0 --port 7999
```

For normal macOS background operation:

```bash
uvx --python 3.13 openbase-coder services start
uvx --python 3.13 openbase-coder services status
```

## Common Commands

```bash
uvx --python 3.13 openbase-coder setup
uvx --python 3.13 openbase-coder doctor
uvx --python 3.13 openbase-coder login
uvx --python 3.13 openbase-coder services status
uvx --python 3.13 openbase-coder services logs django-cli
uvx --python 3.13 openbase-coder plugins list
uvx --python 3.13 openbase-coder bootstrap --help
```

If you installed with `uv tool`, omit `uvx --python 3.13` from those commands.

## Documentation

- [Getting Started](docs/getting-started.md)
- [Commands](docs/commands/index.md)
- [Configuration](docs/configuration.md)
- [Files and Paths](docs/files-and-paths.md)
- [Troubleshooting](docs/troubleshooting.md)

## Development

From this repository:

```bash
uv sync --extra dev
uv run openbase-coder --version
uv run pytest
```

The CLI is part of the larger Openbase Coder multi-workspace. The public setup
flow only syncs the runtime install set required by end users.

## License

Openbase Coder CLI is licensed under
[AGPL-3.0-only](LICENSE).
