Nuphos

The open source Grok Bot alternative for teams.

Nuphos is an open source (Apache-2.0) alternative to xAI's Grok Bot. It gives you always-on Bots that run on the Claude Code or Codex subscription you already pay for, on a managed cloud computer or a machine you own, in chats your whole team can join.

What sets Nuphos apart is the team. Your teammates work with a Bot in the same live session, see the same tool calls, and steer it together. Nuphos is not affiliated with xAI.

Features

• Bots that keep working. Give a Bot a name and a face and chat with it one-on-one. On a cloud computer or a server you keep running, its turn continues after you close your laptop, and you can pick it up from the iOS app.
• Use the subscription you already pay for. Claude Code and Codex each run behind an ACP adapter and sign in with your own Claude or ChatGPT account, so there is no extra model charge on top. OpenCode, Grok Build and Antigravity runtimes are available too.
• Run it where you want. A runtime can be a cloud computer Nuphos manages, a remote machine you own, or your laptop. Move a conversation between them and it keeps going.
• A session is a room with your teammates. Invite someone into a running session the way you would a Notion page, or put people and Bots in the same group chat. Several people talk to the same agent, see the same tool calls, and steer together.
• Share and sync skills and tools across your team. Grant a skill or an integration once and every agent on the team has it, synced, rather than each person pasting a token into their own machine.
• Designed for professional users. The desktop puts a real GUI beside the conversation: a Kubernetes GUI for the cluster, a Grafana GUI for dashboards, alerts, logs and traces, plus GitHub and Linear for repositories, pull requests and issues. GitLab, AWS including ECS, GCP, Cloudflare, Linode, and your MongoDB and SQL connections sit alongside them.
• A browser in the workspace. Open web pages in a desktop tab beside the conversation — docs, a dashboard, the app you are working on — with its own history, instead of switching windows.
• Add the agent to Slack or Discord. One step drops the same agent into a channel the team already uses.
• Triggers. A schedule or a webhook starts a turn on its own — a cron, or an incoming event — without anyone sitting in the chat.
• Split the window. ⌘D splits side by side and ⌘⇧D splits top and bottom, so you can watch several agent sessions at once. Drag a chat from the sidebar onto a pane's edge to open it there, or drag a pane by its grip to move it.
• Memory, with nothing to install. Memory across the team, across agents, and across sessions is built in. There is no MCP server to add before one agent can recall what another learned.

Apps

Path	What it is
apps/backend	Bun/Hono API: accounts, teams, sessions, runtime registry, integrations
apps/desktop	Electron/Vite/React client — the workspace itself
apps/runtime	Claude Code / Codex container images, adapters and independent releases
apps/ios	SwiftUI client: pick a session back up away from your desk
apps/android	Jetpack Compose client for Nuphos Cloud

See apps/android/README.md for Android build and test instructions. The Android client currently uses Nuphos Cloud sign-in; custom self-hosted endpoints are not yet supported.

The agent runtime lives in apps/runtime (Apache-2.0). Its image executes a turn, and a self-hosted deployment registers its own. See apps/runtime/README.md for building, running and independently releasing the runtime.

Releases

Maintainers publish Desktop downloads and self-hosted Backend images through component-specific release tags. See the release guide for versioning, required approvals, and signing setup. Hosted-service deployment is managed separately. Read it before planning or cutting any release; the runtime has its own runtime-vX.Y.Z tags, covered in apps/runtime/README.md. Automated releases may only produce Patch or Minor versions — a Major needs an explicit manual X.0.0.

Self-hosting

Railway currently uses the CLI deployment guide rather than a published one-click template.

deploy/compose brings up a complete, minimal Nuphos with one docker compose up — MongoDB, S3-compatible storage, the backend, and one agent runtime. Start at deploy/compose/README.md.

Railway project templates are also available. For Kubernetes, install the Helm chart.

What to know before you plan around it:

This is the beginning of the README. Read the rest at the original. Read the full README ↗