ohmypi-craft

KO | EN

gitlite — search

#api #tensorflow #electron #windows #claude #data-science #llm #nextjs #editor #ios

(★ 9)

A visual, local-first desktop shell for Oh My Pi — sessions, tools, models, permissions, and long-running agent work.

File Explorer

ZIP Download

- - bug_report.yml
  - feature_request.yml
- - package-electron.yml
  - release-electron.yml
  - validate-server.yml
  - validate.yml
- PULL_REQUEST_TEMPLATE.md
- pre-commit
- - package.json
  - tsconfig.json
- - .gitignore
  - components.json
  - electron-builder.yml
  - eslint.config.mjs
  - package.json
  - README.md
  - tsconfig.json
  - vite.config.ts
- - package.json
  - README.md
  - tsconfig.json
- - index.html
  - package.json
  - tsconfig.json
  - tsconfig.node.json
  - vite.config.ts
- - package.json
  - tsconfig.json
  - vite.config.ts
- - oh-my-pi-hero.svg
- cli.md
- omp-desktop-parity-technical-design.md
- release.md
- - package.json
  - README.md
  - tsconfig.json
- - package.json
  - tsconfig.json
- - package.json
  - tsconfig.json
- - package.json
  - tsconfig.json
  - tsconfig.typecheck.json
- - package.json
  - tsconfig.json
- - package.json
  - README.md
  - tsconfig.json
- - package.json
  - tsconfig.json
- - package.json
  - tsconfig.json
- - eslint.config.mjs
  - package.json
  - tsconfig.json
- - eslint.config.mjs
  - package.json
  - tsconfig.json
- - lint-i18n-changed.test.ts
- - common.ts
  - darwin.ts
  - linux.ts
  - win32.ts
- - assemble-release.ts
  - build-omp-runtime.ts
  - fetch-omp-runtime.ts
  - omp-desktop-parity.patch.br.b64
  - release-meta.ts
  - verify-platform-artifacts.ts
- - ai-settings-ui.ts
- - commands.ts
  - package.ts
  - report.ts
  - run-process.ts
  - runtime.ts
  - signing.ts
  - static.ts
- - helpers.ts
  - runner.ts
- browser-tool.ts
- build-server.ts
- build-wa-worker.ts
- check-i18n-coverage.ts
- check-i18n-parity.ts
- docker-smoke-test.sh
- electron-build-main.ts
- electron-build-preload.ts
- electron-build-renderer.ts
- electron-build-resources.ts
- electron-clean.ts
- electron-dev.ts
- electron-dist.ts
- generate-dev-cert.sh
- install-app.ps1
- install-app.sh
- install-server.sh
- lint-i18n-changed.ts
- lint-i18n-staged.ts
- lint-i18n-strings.ts
- run-doc-tool-smoke.ts
- smoke-electron-packaged.ts
- smoke-omp-hardening.ts
- smoke-omp-runtime.ts
- smoke-omp-todos.ts
- sort-locales.ts
- validate-electron-release.ts
.dockerignore
.env.example
.gitignore
bun.lock
bunfig.toml
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
NOTICE
package.json
PRODUCT.md
README.md
README.zh-CN.md
SECURITY.md
TRADEMARK.md
tsconfig.base.json
tsconfig.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://github.com/BRCOO/ohmypi-craft/releases/latest">Download</a> ·
 <a href="README.zh-CN.md">中文文档</a> ·
 <a href="CONTRIBUTING.md">Contributing</a> ·
 <a href="SECURITY.md">Security</a>

> **Status: active development.** Oh My Pi Desktop is an evolving open-source project. APIs, packaging, and provider integrations may change while the desktop shell reaches release quality.

## Download

Grab the latest packages from the [GitHub Releases page](https://github.com/BRCOO/ohmypi-craft/releases/latest):

| Platform | Package |
| --- | --- |
| macOS | Apple Silicon and Intel `.dmg` / `.zip` |
| Windows | x64 NSIS installer `.exe` |
| Linux | x64 `.AppImage` |

Current packages are unsigned. On macOS, Gatekeeper may require an explicit confirmation; on Windows, SmartScreen may show a warning. Verify the downloaded file with the attached `SHA256SUMS.txt` before launching it.

## What is Oh My Pi Desktop?

Oh My Pi Desktop is a visual, local-first workspace for [Oh My Pi](https://github.com/can1357/oh-my-pi). It brings terminal-grade agent work into a durable desktop surface where sessions, tools, models, permissions, and long-running tasks stay visible and recoverable.

The desktop shell owns the workspace and presentation layer. The Oh My Pi runtime remains the execution layer, connected through a typed JSONL RPC bridge.

## What you can see and control

- **Durable sessions** — organize parallel work with status, search, flags, and session actions.
- **The complete agent loop** — inspect streamed messages, tool calls, plans, todos, diffs, and diagnostics.
- **Explicit permissions** — choose how much autonomy a session has instead of hiding the boundary.
- **Models and providers** — onboard providers, discover models, and control configuration per session.
- **Sources and tools** — manage MCP servers, REST/API sources, local files, Skills, and Agents.
- **Desktop or headless workflows** — use Electron for daily work, or the server/CLI surfaces for automation and remote execution.

## How it works

```mermaid
flowchart LR
 UI["Desktop shell Electron + React"] --> Sessions["Durable sessions"]
 Sessions --> RPC["OMP RPC backend JSONL over stdio"]
 RPC --> Runtime["Oh My Pi runtime"]
 UI --> Sources["MCP · Skills · Sources"]
 Sources --> Sessions
```

The UI keeps session state, permissions, and presentation coherent while the RPC backend translates runtime frames into typed desktop events. This separation keeps the runtime inspectable and the visual layer replaceable.

## Quick start from source

### Prerequisites

- [Bun 1.3.14](https://bun.sh/) — the version used by CI
- Git
- Node.js 18+ for auxiliary tooling

### Run the desktop app

```bash
git clone https://github.com/BRCOO/ohmypi-craft.git
cd ohmypi-craft
bun install
bun run electron:dev
```

For a production-like local build:

```bash
bun run electron:start
```

Configure provider credentials and integrations from the app or your local environment. Keep secrets in `.env` or the OS credential store; never commit them.

## Development commands

```bash
bun run quality:quick

# Full verification gate
bun run quality:verify

# Type checks and tests
bun run typecheck:all
bun test
```

For the CLI surface, see [`docs/cli.md`](docs/cli.md). Release and smoke-test procedures live in [`docs/release.md`](docs/release.md).

## Supported release targets

- macOS: Apple Silicon and Intel
- Windows: x64
- Linux: x64

The release workflow packages a pinned Oh My Pi runtime for each target. Signing and notarization are optional CI capabilities configured through repository secrets.

## Repository layout

```text
apps/electron/              Desktop application: main, preload, renderer, assets
apps/cli/                   Headless/server CLI surface
apps/viewer/                Session viewer surface
apps/webui/                 Browser-facing headless UI
packages/core/              Shared domain types
packages/shared/            Agent backends, config, auth, sources, sessions
packages/server-core/       Session orchestration and runtime services
packages/pi-agent-server/   Pi/OMP runtime bridge
packages/ui/                Shared UI primitives
scripts/                    Build, quality, release, and smoke-test tooling
docs/                       Public CLI and release documentation
```

## Privacy and security

Oh My Pi Desktop is built for local-first agent work. Workspace data and credentials are handled by local application layers; remote server mode is opt-in and protected by an explicit token. Review [`SECURITY.md`](SECURITY.md) before reporting a vulnerability, and never include API keys, credentials, or private workspace data in issues.

## Contributing

Bug reports, feature ideas, documentation improvements, and focused code contributions are welcome. Start with [`CONTRIBUTING.md`](CONTRIBUTING.md), then use the repository templates for [bug reports](.github/ISSUE_TEMPLATE/bug_report.yml), [feature requests](.github/ISSUE_TEMPLATE/feature_request.yml), and pull requests.

## License and attribution

Oh My Pi Desktop is released under the [Apache License 2.0](LICENSE).

This repository contains code derived from the Craft Agents open-source project. See [`NOTICE`](NOTICE) and [`TRADEMARK.md`](TRADEMARK.md) for attribution and trademark guidance. Oh My Pi is an independent project and is not endorsed by Craft Docs Ltd.

If this project helps your workflow, a star is the simplest way to support it. Issues and concrete feedback are even more valuable while the release surface is being hardened.

ohmypi-craft

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README