8000 GitHub - QwertyCoolMT/omnigent: Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device. · GitHub
[go: up one dir, main page]

Skip to content

About

Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

Omnigent Windows Native Fork

This repository is an unofficial Windows-focused fork of omnigent-ai/omnigent.

It is not the official Omnigent project, website, desktop app, hosted service, or release channel. The upstream project, name, assets, and official docs belong to the upstream maintainers. This fork exists to make local Windows development and collaboration easier while Windows support is still experimental upstream.

Use the official repository for general Omnigent documentation:

https://github.com/omnigent-ai/omnigent

What This Fork Changes

This fork carries Windows runtime compatibility work on top of upstream Omnigent, including:

  • avoiding Unix-only imports such as resource and fcntl during Windows startup
  • using Windows-compatible subprocess process-group handling
  • supporting per-conversation harness subprocesses over loopback TCP when Unix domain sockets are unavailable
  • adding loopback-token protection for local TCP harness endpoints
  • making host daemon terminal output safe for Windows console encodings
  • making the default Windows sandbox posture explicit and fail-closed
  • skipping POSIX-only terminal bridge tests on Windows

The package and CLI names remain upstream-compatible: omnigent and omni.

Current Windows Status

Validated on Windows with Python 3.12 using the Windows-relevant server, host, harness, sandbox, terminal bridge, and Claude bridge tests:

225 passed, 31 skipped

The skipped tests are POSIX terminal or tmux paths. Native Windows terminal session support is not complete in this fork.

Windows Prerequisites

Install these first:

  • Windows 10 or 11
  • PowerShell
  • Git
  • Python 3.12
  • Node.js LTS, 22 or newer
  • uv

Typical install commands:

winget install -e --id Git.Git
winget install -e --id Python.Python.3.12
winget install -e --id OpenJS.NodeJS.LTS
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Restart PowerShell after installing so git, python, node, npm, and uv are on PATH.

Install This Fork

If you have the official package installed as a uv tool, remove it first so the fork is the one on your PATH:

uv tool uninstall omnigent

Install this fork directly from GitHub:

uv tool install --python 3.12 git+https://github.com/QwertyCoolMT/omnigent.git

Check the CLI:

omnigent --help
omni --help

For development from a clone:

git clone https://github.com/QwertyCoolMT/omnigent.git
cd omnigent
uv sync
uv run omnigent --help

Configure Model Access

Run the setup flow and add whichever provider credentials you use:

omnigent setup

Omnigent can use provider API keys, compatible gateways, or supported local CLI subscriptions depending on the harness you choose. Keep credentials out of Git.

Run Locally On The Windows Machine

Start the local server and web UI:

omnigent server start

Open:

http://127.0.0.1:6767

Check status:

omnigent server status
omnigent host status

Stop everything:

omnigent stop

Share On Your Local Network

The background server start command binds to 127.0.0.1, so other devices cannot see it. For phone, tablet, or teammate access on the same trusted LAN, run the foreground server bound to all local interfaces:

$env:OMNIGENT_AUTH_ENABLED = "1"
omnigent server --host 0.0.0.0 --port 6767 --admin-password "replace-with-a-real-password"

Keep that PowerShell window open.

In a second PowerShell window, register this Windows machine as the local host that can run sessions:

omnigent host --server http://127.0.0.1:6767

Find your LAN address:

ipconfig

From another device on the same network, open:

http://YOUR-WINDOWS-LAN-IP:6767

Example:

http://192.168.5.194:6767

If Windows Firewall blocks the page, allow inbound TCP 6767 on the Private network profile:

New-NetFirewallRule `
  -DisplayName "Omnigent Windows Fork 6767" `
  -Direction Inbound `
  -Protocol TCP `
  -LocalPort 6767 `
  -Action Allow `
  -Profile Private

Do not expose this server directly to the public internet. Use a VPN such as Tailscale, a private network, or a properly secured reverse proxy.

Known Windows Limitations

  • Native POSIX terminal flows that require tmux, pty, fcntl, or Unix signals are not Windows-native yet.
  • The Windows sandbox backend is intentionally fail-closed. The base install does not provide a Windows kernel sandbox equivalent to bubblewrap or macOS seatbelt.
  • If an agent explicitly needs to run without a sandbox on Windows, set os_env.sandbox.type: none only when you accept host-level execution risk.
  • Some upstream docs and examples assume Linux or macOS. Treat those as upstream behavior unless this README says otherwise.

What Was Removed From This README

The upstream README contains official project marketing, the official website, macOS desktop app links, broad deployment positioning, and upstream maintainer language. Those are not appropriate for this fork's front page.

This README intentionally focuses on:

  • the fork's unofficial status
  • Windows setup
  • local collaboration on a trusted network
  • current Windows limitations

Contributing To This Fork

Keep changes scoped to Windows enablement, Windows documentation, or fixes that are needed to keep the fork usable on Windows. General Omnigent changes should normally go upstream first.

Before publishing Windows runtime changes, run the targeted Windows checks:

$env:PYTHONUTF8 = "1"
python -m pytest `
  tests\server\test_performance_metrics.py `
  tests\server\integration\test_host_tunnel_route.py `
  tests\server\integration\test_host_liveness_staleness_e2e.py `
  tests\server\routes\test_host_launch.py `
  tests\runtime\harnesses\test_process_manager.py `
  tests\runtime\harnesses\test_runner.py `
  tests\runtime\harnesses\test_scaffold.py `
  tests\sandbox\test_sandbox.py `
  tests\terminals\test_ws_bridge.py `
  tests\test_claude_native_bridge.py `
  tests\policies\builtins\test_enforce_sandbox.py

License

This fork keeps the upstream Apache 2.0 license. See LICENSE.

About

Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents — swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0