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.