buildersoftdev/sophon repository overview

⁠Sophon Gateway

Sophon is your always-on AI assistant — one companion that lives across all your messages, calendar, notes, files, and tools, remembers what matters to you, and acts on your behalf across every channel you already use. The Gateway is the brain behind it: the always-on service that runs your agents, manages your memory, schedules your work, and coordinates every AI provider, channel, and integration you've connected.

Think of Sophon as a single, private, always-on digital chief of staff — running on your laptop, your server, or your Kubernetes cluster, fully under your control.

Learn more at sophon.buildersoft.io⁠.

⁠About the name

Sophon is named after the sophon — the proton-sized supercomputer from Liu Cixin's The Three-Body Problem. In the novel, a single sophon particle carries immense intelligence and reach across vast distances. Our Sophon is built in the same spirit: vast capability in a small, elegant package that is quietly always with you.

⁠What Sophon does

Chat anywhere, one brain. Sophon plugs into the channels you already use — WhatsApp, Telegram, Discord, Slack, Teams, Signal, Email, SMS, Matrix, LINE, and more — and brings them into a single, continuous conversation your assistant can work across. Nothing lives in your head twice.

Remembers what matters. Every conversation, every note, every document you share becomes searchable context. Daily journals. Long-term notes. People, projects, and the relationships between them. Nothing important is lost; nothing sensitive is overshared.

Does the boring work. Drafts emails. Summarises long documents. Schedules follow-ups. Books time on your calendar. Creates tasks. Uses any skill — bundled, installed from the Marketplace, or authored on demand by the assistant itself.

Talks to the rest of your stack. Gmail, Calendar, GitHub, Notion, Jira, Linear, Apple Notes, Home Assistant, your internal API — Sophon connects safely through a credential vault you own.

Your AI, your rules. Bring your own model: Anthropic Claude, OpenAI, Google Gemini, GitHub Copilot, Ollama running locally, or any OpenAI-compatible endpoint. Mix providers. Set budgets. Fall over automatically when one goes down.

Safety without paranoia. Human-in-the-loop approvals for any action that sends, spends, or deletes. Full audit trail. Code execution runs fully sandboxed. Credentials are brokered — the AI never sees the raw token.

Voice when you need it. Full-screen voice mode with barge-in, your choice of TTS provider, always a button away. Talk to Sophon the way you'd talk to a person.

Extensible by design. Author your own skills in C# or Python. Publish to the Marketplace. Compose workflows visually. Build plugins that extend channels, document extractors, model providers, or vault backends.

⁠How it runs

Sophon scales with your needs, not before. Same binary across all tiers — switch by configuration, not by migration:

⁠Get started

docker run -d \
  --name sophon-gateway \
  -p 8080:8080 \
  -v ~/.sophon:/home/sophon/.sophon \
  buildersoftdev/sophon:1.15.0

Then run the Dashboard image⁠ and open it in your browser. The Setup Wizard walks you through:

1. Adding your first AI provider (paste an API key, sign in with OAuth, or point at a local Ollama endpoint)
2. Choosing your assistant's personality
3. Connecting the channels you want (WhatsApp, Telegram, Slack, Email…)
4. Optionally connecting services (Gmail, Calendar, GitHub, Notion, Home Assistant…)

Sophon ships with zero default access — no AI providers, no channels, no credentials until you add them yourself. Nothing leaves your machine until you explicitly permit it.

⁠Docker Compose

⁠Personal tier

The simplest way to run Sophon — a single Gateway + Dashboard with a built-in SQLite database. Save the following as docker-compose.yml and run docker compose up -d:

services:
  sophon-gateway:
    image: buildersoftdev/sophon:1.15.0
    ports:
      - "8080:8080"
    volumes:
      - sophon-data:/home/sophon/.sophon
    environment:
      - SOPHON__Tier=Personal
    restart: unless-stopped

  sophon-dashboard:
    image: buildersoftdev/sophon-dashboard:1.15.0
    ports:
      - "80:80"
    environment:
      - SOPHON_GATEWAY_URL=http://sophon-gateway:8080
    depends_on:
      - sophon-gateway
    restart: unless-stopped

volumes:
  sophon-data:

Open http://localhost to reach the Dashboard.

⁠Pro tier

For heavier workloads — adds PostgreSQL for persistent storage and Qdrant for semantic memory search:

services:
  sophon-gateway:
    image: buildersoftdev/sophon:1.15.0
    ports:
      - "8080:8080"
    volumes:
      - sophon-data:/home/sophon/.sophon
    environment:
      - SOPHON__Tier=Pro
      - SOPHON__Database=postgresql
      - ConnectionStrings__PostgreSQL=Host=postgres;Database=sophon;Username=sophon;Password=sophon
      - Qdrant__Endpoint=http://qdrant:6334
    depends_on:
      postgres:
        condition: service_healthy
      qdrant:
        condition: service_started
    restart: unless-stopped

  sophon-dashboard:
    image: buildersoftdev/sophon-dashboard:1.15.0
    ports:
      - "80:80"
    environment:
      - SOPHON_GATEWAY_URL=http://sophon-gateway:8080
    depends_on:
      - sophon-gateway
    restart: unless-stopped

  postgres:
    image: postgres:17
    environment:
      POSTGRES_DB: sophon
      POSTGRES_USER: sophon
      POSTGRES_PASSWORD: sophon
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U sophon"]
      interval: 5s
      timeout: 3s
      retries: 5
    restart: unless-stopped

  qdrant:
    image: qdrant/qdrant:latest
    volumes:
      - qdrantdata:/qdrant/storage
    restart: unless-stopped

volumes:
  sophon-data:
  pgdata:
  qdrantdata:

⁠Tags

Sophon images are tagged with their exact version only. There is no :latest, :stable, or rolling tag — always pull a specific version.

docker pull buildersoftdev/sophon:1.15.0

Replace 1.15.0 with the version you want. See GitHub Releases⁠ for the current list.

⁠Architectures

• linux/amd64

On ARM64 hosts (Apple Silicon, AWS Graviton, Raspberry Pi) Docker can still pull linux/amd64 via runtime emulation; native linux/arm64 Gateway images are a planned follow-up.

⁠Configuration

Most configuration happens in the Dashboard UI — you don't edit files by hand. All secrets are stored encrypted under ~/.sophon/config/ using the OS keyring (DPAPI on Windows, Keychain on macOS, libsecret on Linux).

For the full configuration reference, visit sophon.buildersoft.io⁠.

⁠Volumes

Back up this single directory and you have backed up everything.

⁠Ports

⁠Health & version

curl http://localhost:8080/api/health     # { status, tier, version, ... }
curl http://localhost:8080/api/version    # { semantic, full, gitSha, builtAt }

⁠Links

• Product site · Documentation · Support: sophon.buildersoft.io⁠
• Companion image: buildersoftdev/sophon-dashboard⁠
• A product of Buildersoft LLC⁠

Sophon is a commercial product. © Buildersoft LLC. All rights reserved.