Skip to content

Latest

Latest

Choose a tag to compare

@github-actions github-actions released this 01 Oct 07:19
1950765

Mimo Latestlatest-20261001-1950765

License: AGPL-3.0-only — Source code available at https://github.com/bit4bit/mimo

This is the latest development build from the main branch.

Installation

Download the appropriate binary for your platform and make it executable:

# Linux
chmod +x mimo-platform-linux-x64 mimo-agent-linux-x64

# macOS
chmod +x mimo-platform-darwin-arm64 mimo-agent-darwin-arm64

Running the Platform Server

Start the web platform (runs on port 3000 by default):

# Linux
./mimo-platform-linux-x64

# macOS
./mimo-platform-darwin-arm64

Configuration via environment variables:

export PORT=3000                    # Server port (default: 3000)
export JWT_SECRET="your-secret"     # JWT signing key (required)
export MIMO_HOME="$HOME/.mimo"      # Data directory (default: ~/.mimo)

./mimo-platform-linux-x64

The platform listens on the PORT you specify (default 3000). Use a different port by setting PORT=8080 ./mimo-platform-linux-x64

Running the Agent

Start an agent that connects to the platform:

# Linux
./mimo-agent-linux-x64 --token <AGENT_JWT> --platform ws://localhost:3000/ws/agent --provider opencode

# macOS
./mimo-agent-darwin-arm64 --token <AGENT_JWT> --platform ws://localhost:3000/ws/agent --provider opencode

Getting an agent token:

  1. Start the platform server
  2. Go to http://localhost:3000/agents
  3. Create a new agent and copy the JWT token

Available providers: opencode or claude

Verification

Verify checksums:

sha256sum -c checksums.txt

Notes

  • Binaries are single-file executables with all assets embedded
  • No runtime dependencies required (includes Bun runtime)
  • Static assets are served from embedded memory when running compiled binary
  • First run creates ~/.mimo directory for data storage