Repository navigation
UM-Codex v0.1.0-alpha.1
·
108 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
UM-Codex 0.1.0-alpha.1: the first release
Full-power OpenAI Codex on the U-M GPT Toolkit, running in a sealed Docker environment on your Mac or Windows computer. At each launch you choose:
- which folders Codex can change;
- which it can only read;
- whether it can use the internet.
Then Codex opens in your terminal.
Install
- Mac:
curl -fsSL https://github.com/SripadaLab-UM/um-codex/releases/latest/download/install-macos.sh | sh - Windows (PowerShell):
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; irm https://github.com/SripadaLab-UM/um-codex/releases/latest/download/install-windows.ps1 | iex
The installer:
- installs Docker Desktop if you don't have it;
- on Windows, also turns on WSL and fixes Docker's VM logon right if needed;
- asks for your Toolkit API key, which goes into your Keychain or Credential Manager and never into the container;
- adds a UM-Codex app to the Desktop.
What's in it
- Saved setups: a working folder, more folders to change or only read, internet on or off, the model, and approvals. A summary screen comes before each launch.
- Your key stays out of the container. A relay on your computer adds it to Codex's requests, so nothing Codex runs can read it.
- When you quit, everything is removed except Codex's history for that setup, so
codex resumeworks. - Commands:
um-codex doctor,um-codex key,um-codex update(signed releases, with--rollback) andum-codex uninstall.
Known limits
- With the internet on, Codex can also reach services on your own computer and on your local network or VPN. The launch screen says so.
- This alpha hasn't had a full install on a fresh Windows computer yet. CI runs the Windows installer's checks on a real Windows runner.
Install (or update to this version with the installer):
- Mac, in Terminal:
curl -q -fsSL https://github.com/SripadaLab-UM/um-codex/releases/latest/download/install-macos.sh | sh - Windows, in Windows PowerShell:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; irm https://github.com/SripadaLab-UM/um-codex/releases/latest/download/install-windows.ps1 | iex
Already installed: um-codex update.
Images, pinned by digest:
- Agent:
ghcr.io/sripadalab-um/um-codex-agent@sha256:0b2eafa94fa781e5ffb63d3d1c5712a4b19f44f3021c752f2b1e9bf2cd89e8bb - Gateway:
nginx@sha256:5616878291a2eed594aee8db4dade5878cf7edcb475e59193904b198d9b830de
SHA256SUMS is signed with UM-Codex's release key (SHA256SUMS.sig); um-codex update checks it.
To check a download against SHA256SUMS: shasum -a 256 -c SHA256SUMS --ignore-missing
on Mac, or compare Get-FileHash <file> with it on Windows.