Simeon
A team of always-on agents on your Mac, each with a computer of its own.
Simeon is made by Simeon Labs (simeonlabs.com).
This repository holds the whole product:
| Folder | What it is |
|---|
mac/ | The Mac app, in SwiftUI. |
ios/ | The iPhone app, in SwiftUI; ios/SimeonCore is shared with the Mac app. |
desktop/ | The retired Electron Mac app (11 October 2026), kept only to build the agent loop that runs on each person's cloud computer, and the web app's window. |
server/ | The API at api.simeonlabs.com: sign-in, the model proxy, memory, the cloud computers, routines, sharing, connectors, billing. FastAPI and PostgreSQL. |
runner/ | The cloud runner: does a person's queued work when their Mac is closed. |
clients/ | The web app at app.simeonlabs.com (sign-in pages and the account dashboard) and its shared packages. |
sites/simeonlabs.com/ | The public website, with the live demo. |
docs/ | How it fits together, how to build it, what each server feature does, and how to run the servers. |
Start with docs/README.md.
Build the apps
On a Mac with Xcode: the Mac app with mac/scripts/build.sh
(mac/README.md), the iPhone app from ios/
(ios/README.md).
The agent loop for the cloud computers is still built through the retired
Electron app, on a Mac (desktop/README.md):
cd desktop
npm ci && npm run bootstrap && npm run check && npm run package && npm run publish:host-bundle
Run the server and web app locally
# API (http://127.0.0.1:8000)
cd server
docker compose up -d # PostgreSQL, Redis, MinIO
uv sync && uv run task api
# Web app (http://127.0.0.1:3000)
cd clients
pnpm install && pnpm dev
# Tests
cd server && uv run task test
cd clients && pnpm test
cd desktop && npm test
Settings are read from the environment as SIMEON_<NAME> (the earlier
CLAIDOR_<NAME> is still read, so deployments keep working while they are
renamed). The environment is chosen by SIMEON_ENV.
Licence
The server and web app are derived from Polar
(Polar Software Inc.) and are under the Apache 2.0 licence in LICENSE;
NOTICE lists the attributions. The Mac app's origin and terms are in
desktop/NOTICE.md.
