seira

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 8 GitHub stars
Code Basarisiz
  • process.env — Environment variable access in .github/workflows/ci.yml
  • rm -rf — Recursive force deletion command in .github/workflows/package-macos.yml
  • process.env — Environment variable access in .github/workflows/package-macos.yml
  • rm -rf — Recursive force deletion command in .github/workflows/package-windows.yml
  • process.env — Environment variable access in .github/workflows/package-windows.yml
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Your own team of AI agents in one chat app. Local first, open source, Apache 2.0.

README.md
Seira: a white 3D robot head with silver hair panels, a black visor screen, glowing red eyes, and a small smile

seira.bot

Your own team of AI agents in one chat app.

Give each bot a job. Watch it work. Approve the steps that matter.

Seira runs on your computer and uses the AI plans that you already have.

Latest release npm package @seira-bot/seira License: Apache 2.0 Platforms: Windows, Linux, and macOS Engines: Claude, Codex, Gemini, Grok, and more than 25 others

Website · Quick start · Features · Engines · How it works · Documentation · Contributing

[!NOTE]
Seira is in early development.
Download it for Windows or Linux from the latest release,
run the server with npx @seira-bot/seira, or build it from source.

Why Seira

Bring your own agents

Bots run on the agent programs on your computer: Claude Code, Codex, Gemini, Cursor, GitHub Copilot, and many more. They use the sign-in and the plan that you already have. There is no new account and no proxy in the middle.

Ready on the first start

No AI on your computer yet? Seira installs OpenCode and its free models as a backup, so you can chat before you connect a paid plan.

Agents with hands

A bot can use a cloud Linux desktop, an isolated local VM, or your own computer after you opt in. With your own Composio key, it can also use more than 500 apps.

Local first, you stay in control

One small harness server on 127.0.0.1 owns every agent process. Transcripts and keys stay on your computer. Shell commands, file edits, and questions show as cards that you allow or deny.

Features

Feature What you get
A model for each bot Pick the engine and the model of each bot from one model picker. Change the model in the middle of a conversation.
A character for each bot Each new bot gets its own character. Pick a different look from the cast at any time.
A computer for each bot Open the Computer panel to start the cloud desktop of a bot. Watch a live preview, or take over in your browser.
Approval cards A permission broker turns each risky action into a card: Allow, Deny, or answer in the chat.
Connected apps Add your Composio key, then connect Gmail, Slack, GitHub, Notion, Linear, and hundreds more. Every bot can use them.
Channels Keep Work, Personal, and each project apart. Each channel has its own transcript, instructions, work folder, and bot roster.
Triggers Tell a bot "every weekday at 9, summarize my inbox". Schedules and webhooks start bots while you do other work.
Voice Listen to replies, or call a bot. Voices come from ElevenLabs, Fish Audio, xAI, built-in Mac voices, or a local Chatterbox server.
Teams Install a full team from one Markdown file. Share a bot or a department as a folder.
Run it anywhere Use the desktop app, or run the same server on a VPS or a home server and open it from your browser or phone.
MCP server Control your bots from Claude Desktop, Cursor, or another MCP client. See docs/mcp-server.md.
Scripts and CI Start a team from the command line, wait for the result, and export what it made. See docs/headless-cli.md.

Engines

Seira has more than 30 engines. Install an agent program and sign in, or add an API key.
The model picker shows each engine that is ready.

Kind Engines
Agent programs Claude Code, Codex, pi
Agent programs over ACP Gemini, Google Antigravity, Grok, Cursor, GitHub Copilot, OpenCode, Qwen, Kimi, Droid, Cline, Kiro, Devin, Hermes, DeepSeek, Mistral (Vibe), Command Code, OMP
API and plan engines Grok, Mistral, Groq, Cerebras, MiniMax, Greenference, ModelGo, Meta Muse, Muse Code, and any OpenAI-compatible endpoint

To add an ACP program or an endpoint that is not in this list, see docs/custom-engines.md.
To use a custom build of an agent program, set it in Settings → Engines.

Meet Seira

Seira is the face of the project: a small companion bot that floats next to your chats.
The face lives on a black visor screen, so Seira can blink, smile, wink, and think while your agents work.

Six expressions of Seira: calm smile, eyes closed, happy, surprised, wink, and thinking

Brand assets: turnaround, colors, and logo files

Seira from the front, three-quarter, side, and back

Color Hex Use
Ink #0E1116 Head and wordmark on light backgrounds
Signal red #E11D48 Eyes, and the dot in seira.bot
Mist #E9ECEF Head on dark backgrounds

The 3D logo, the wordmark, the lockups for light and dark backgrounds, and the avatar are in docs/assets/brand/.

How it works

Seira runs as two processes.
The app sends typed commands over HTTP and reads one event stream (SSE).
The harness server owns every agent process.
It changes the protocol of each engine into one event stream, and logs each thread as NDJSON.

flowchart LR
    subgraph app ["Seira app: React + Tailwind"]
        UI[Chat · model picker · computer panel]
    end
    subgraph server ["Harness server (127.0.0.1)"]
        REG[Driver registry] --> BUS[Event bus → SSE]
        BROKER[Permission broker]
    end
    subgraph agents ["Engines"]
        CLI[Agent programs<br>claude · codex · pi]
        ACP[ACP agents<br>gemini · antigravity · cursor · copilot · opencode · …]
        API[API engines<br>OpenAI-compatible endpoints]
    end
    UI -- "HTTP commands" --> server
    BUS -- "one SSE stream" --> UI
    REG --> CLI & ACP & API
    CLI & ACP -- "permission requests" --> BROKER
    server -- "Boat API" --> BOAT[("Cloud computer")]
    server -- "Composio" --> APPS[("Gmail · Slack · GitHub · …")]
Code map: where each layer lives
Layer Path What it does
Drivers server/drivers/ One driver for each engine. ACP agents are in server/drivers/acp/. An unknown driver shows as "unavailable" and does not stop the other bots.
Harness server/harness/ The registry that turns configs into live bots, and the event bus that every client reads.
API server/index.ts Bots, turns, approvals, models, computers, connectors, and config over HTTP and SSE.
Voice server/tts/ Speech for replies and calls. Cloud keys stay on the harness server.
App src/ The chat app. One store from the server, one reducer, and no transport in the client.
Desktop electron/ The shells for macOS, Windows, and Linux, with the harness server inside.

Quick start

Download the app from the latest release:

  • Windows 10 or later: Seira-setup.exe. If Windows warns you, select More info, then Run anyway.

  • Linux x64: Seira-<version>-x86_64.AppImage. Make it executable, then open it:

    chmod +x Seira-*-x86_64.AppImage
    ./Seira-*-x86_64.AppImage
    

The app updates itself. Each release also has a SHA256SUMS file for each system, to check your download.
There is no macOS download yet. On macOS, run the server with Node, or build Seira from source.

Run it on a server

The npm package @seira-bot/seira is the same server without the desktop shell.
It needs Node.js 24 or later.

npx @seira-bot/seira setup              # once: AI access and a default model
npx @seira-bot/seira serve --tailscale  # or --lan, --domain, --public-url, --tunnel

The server prints a pairing link. Open it in your browser or on your phone.
docs/self-hosting.md explains each way to reach the server, and the Docker image.

Build from source

You need:

  • macOS, Windows, or Ubuntu 24.04 x64.
  • Node.js 24 or later, and pnpm 10.
    To get pnpm, run corepack enable.
    On Windows, run it in a terminal opened as administrator, or install pnpm with npm install -g [email protected].
  • An engine is optional. If no engine is ready, Seira installs OpenCode with free models at the first start.
    For your own plans, install and sign in to claude, codex, or another engine.

Run each dev command in its own terminal:

git clone https://github.com/seira-bot/seira.git && cd seira
pnpm install

pnpm dev:server    # harness server on 127.0.0.1:8799
pnpm dev           # app on http://127.0.0.1:5199
pnpm dev:desktop   # Electron shell; keep the two commands above running

Optional keys

Local chat works without these keys.
To turn on an integration, paste its key in App Settings (the gear at the bottom of the sidebar).

Key What it turns on Where to get it
Composio project key (ak_…) Gmail, GitHub, Slack, Notion, and other apps for your bots docs/composio.md
Boat API key An isolated remote Linux computer with a desktop and a terminal for each bot Boat API keys
ElevenLabs key Spoken replies and calls ElevenLabs API keys
Fish Audio key Spoken replies and calls with Fish Audio voices Fish Audio API keys

Composio and Boat are third-party services with their own accounts and terms.
Boat is a paid service after its trial, and a cloud computer can cost money.

Check and build

pnpm typecheck       # app and server
pnpm test            # unit, driver, API, and desktop tests
pnpm build           # typecheck and production build
pnpm check:electron  # syntax check of the Electron files

Package the desktop app

pnpm package:mac     # macOS: DMG and ZIP (needs Swift and Xcode tools)
pnpm package:win     # Windows: installer and ZIP
pnpm package:linux   # Linux x64: AppImage, snap, and the verified Cua runtime

docs/linux-desktop.md covers the snap, and the Flatpak build in packaging/flatpak/.
docs/releasing.md explains how a release is made.

Desktop support for each system
Capability macOS Windows x64 Ubuntu 24.04 Xorg Ubuntu 24.04 Wayland
Packaged app, harness server inside, local engines Supported Supported Beta Beta
Composio and Boat cloud computers Supported Supported Beta Beta
Preview of the local screen Supported Not available Beta Beta
Bot control of this computer Supported Supported Beta, after you opt in Off for safety
Dictation on the device Supported Not available Planned Planned
Dictation and calls through Fish Audio Not used Supported Supported Supported

See docs/linux-desktop.md and docs/computer-use-integration.md.

Privacy

A Seira build sends no analytics.
The code can send them, but only to a PostHog project whose key you give when you build the app.
They are anonymous and never include keys, names, addresses, or conversations.
docs/analytics.md lists each event and each property.

[!IMPORTANT]
This repository has no analytics key.
A build made without VITE_SEIRA_POSTHOG_TOKEN has no analytics switch in Settings and sends nothing.
A build made with a key sends analytics until you turn off Settings → General → Usage analytics.

Documentation

Topic Guide
Your own engines (ACP programs, OpenAI-compatible endpoints) docs/custom-engines.md
OpenCode and its free models docs/opencode-go.md
Your own MCP tool servers docs/custom-mcp-servers.md
Self-hosting on a server docs/self-hosting.md, docs/deploy-vps.md
Command line and CI docs/headless-cli.md
Linux desktop, Snap, and Flatpak docs/linux-desktop.md
Voice docs/voice-mode.md
Team sharing docs/team-sharing.md
Routing with a decision model docs/decision-model.md
Feature switches docs/feature-flags.md
Other model providers apps/docs/…/model-providers.mdx

Contributing

Issues and pull requests are welcome.
CONTRIBUTING.md explains how a change lands, the code guide holds the code rules,
and DESIGN.md holds the design rules.

The driver contract in server/contracts.ts is small.
To add an engine, add one file in server/drivers/ and register it with one line in server/drivers/builtIn.ts.

Do not post a security problem in public. Report it through private vulnerability reporting.
SECURITY.md gives the details.

License

  • The code is under the Apache License 2.0.
    NOTICE names the projects that Seira uses code from, with their authors and licenses.
    LICENSING.md gives the details.
  • Bundled third-party parts keep their own licenses. See third_party/.
  • The Apache License does not give rights to the Seira name, logo, or mascot (section 6).

Seira is an independent project. It is not affiliated with or endorsed by Anthropic, OpenAI, Google, or xAI.
Claude, Codex, Gemini, Grok, and the other engine names are trademarks of their owners.


Yorumlar (0)

Sonuc bulunamadi