myOrb

myOrb is your personal AI-powered daily briefing dashboard. It connects to email, calendar, tasks, finances and other third-party services, then uses AI to summarize what matters today: unread and new emails, upcoming events, open TODOs, spending and more. Self-hosted, extensible with plugins and written in Python.

🚧 Work in progress.

Your assistant is yours to name: call it J.A.R.V.I.S., Iris, HAL 9000 or anything else at setup, and it greets you, sits in the middle of the orb and writes your brief under that name.

Run on your computer

You need uv (it installs the right Python by itself).

git clone https://github.com/eriktelepovsky/myorb.git
cd myorb
uv sync
uv run myorb serve

Open http://localhost:8000 and choose a password. Data (the SQLite database and the encryption key) is stored in ./data.

Settings come from MYORB_* environment variables or a .env file in the project directory, e.g.:

MYORB_TIMEZONE=Europe/Bratislava

Local domain

To open myOrb at http://myorb.localhost instead, run it on port 80 with uv run myorb serve --host 0.0.0.0 --port 80, or put MYORB_HOST=0.0.0.0 and MYORB_PORT=80 in .env. macOS allows port 80 without sudo only on all network interfaces, so myOrb is then also reachable from your local network, protected by the login. Addresses ending in .localhost point to your own computer in macOS and modern browsers, so no hosts entry is needed. Passkeys only work at the address where they were added, so always use the same one.

Google accepts sign-in redirects only on localhost or over HTTPS, so connect Google while myOrb is open at http://localhost (see Integrations → Google).

Run with Docker

The image is ghcr.io/eriktelepovsky/myorb, built for amd64 and arm64 and published with every release.

Docker Compose

curl -O https://raw.githubusercontent.com/eriktelepovsky/myorb/main/compose.yaml
echo "MYORB_TIMEZONE=Europe/Bratislava" > .env
docker compose up -d
docker logs myorb

The log contains a setup link (/setup?token=…). Open it at http://your-server:8000 and choose a password. Requests reach the container from the Docker network, so setup always needs this link. Data is stored in the myorb-data volume.

Plain Docker

docker run -d --name myorb --restart unless-stopped \
  -p 8000:8000 -v myorb-data:/data \
  -e MYORB_TIMEZONE=Europe/Bratislava \
  ghcr.io/eriktelepovsky/myorb:latest
docker logs myorb

Build the image yourself

Until the first release is published, or to run your own changes, build the image from the source and use it with the commands above:

docker build -t ghcr.io/eriktelepovsky/myorb:latest .
docker compose up -d

Run in production

In production, myOrb runs behind a reverse proxy that provides HTTPS on your domain. HTTPS is required for passkeys, for connecting Google and for installing myOrb as an app on a phone.

This example uses Caddy, which gets a certificate from Let's Encrypt automatically. Point your domain's DNS record to the server, then put these two files in one directory:

compose.yaml:

services:
  myorb:
    image: ghcr.io/eriktelepovsky/myorb:latest
    container_name: myorb
    restart: unless-stopped
    volumes:
      - myorb-data:/data
    environment:
      MYORB_TIMEZONE: Europe/Bratislava
      MYORB_PUBLIC_URL: https://myorb.example.com
      # Caddy reaches myOrb from the Docker network (in 172.16.0.0/12 by default);
      # trust its X-Forwarded-* headers.
      MYORB_TRUSTED_PROXIES: 172.16.0.0/12
      MYORB_SECRET_KEY: ${MYORB_SECRET_KEY}

  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy-data:/data

volumes:
  myorb-data:
  caddy-data:

Caddyfile:

myorb.example.com {
    reverse_proxy myorb:8000
}

Generate the encryption key once and keep it safe, e.g. in a password manager:

echo "MYORB_SECRET_KEY=$(openssl rand -hex 32)" > .env
docker compose up -d
docker logs myorb

Open the setup link from the log at https://myorb.example.com/setup?token=…. myOrb is not exposed directly: only Caddy publishes ports.

Then, in myOrb:

• Google: in your OAuth client in Google Cloud Console, add the redirect URI https://myorb.example.com/integrations/google/callback. You can keep using the same client as for local development.
• Claude: add your Anthropic API key in Integrations → Claude.

Settings

Updates and backups

Update to the latest release:

docker compose pull
docker compose up -d

Database migrations run automatically at startup.

Back up the database while myOrb runs (SQLite's backup keeps it consistent), then copy it out of the container:

docker exec myorb python -c "import sqlite3; sqlite3.connect('/data/myorb.db').backup(sqlite3.connect('/data/backup.db'))"
docker cp myorb:/data/backup.db ./myorb-backup.db

Without MYORB_SECRET_KEY, also back up /data/secret.key; the connected accounts in the backup cannot be read without it.

Development

uv sync
uv run myorb serve --reload   # restarts on code changes
uv run pytest
uv run ruff check . && uv run ruff format --check .

See the architecture for how myOrb is built, and writing plugins to connect your own services.

Roadmap

See the roadmap for planned features and their order.

Contributing

Contributions are welcome! Before your first pull request can be merged, you need to sign the Contributor License Agreement. The CLA bot will guide you through it with a single comment in your pull request.

License

Copyright © 2026 Erik Telepovský

myOrb is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). If you run a modified version of myOrb as a network service, you must make its source code available to its users.

For commercial licensing that is not subject to the AGPL terms, please contact the author.