Getting Started

Get UltraSushiTron running locally in a few minutes.

Prerequisites

  • Rust 1.75+ — install via rustup
  • Node.js 18+ or Bun — for the mobile app
  • Protobuf compiler — protoc for gRPC codegen
  • Expo CLI — for mobile development (optional)

Clone and Build

1. Clone the repository

Terminal bash 
git clone https://github.com/jaikoo/UltraSushiTron.git
cd UltraSushiTron

2. Build the Secrets Agent

The secrets agent is an air-gapped Rust microservice that manages your encrypted vault.

Terminal bash 
cd secrets-agent
cargo build --release

3. Build the AI Core

The core provides the LLM orchestration layer with 11 built-in tools.

Terminal bash 
cd core
cargo build --release

4. Run with Docker (alternative)

A Docker Compose setup is available for quick start:

Terminal bash 
docker compose up

Running UltraSushiTron

Start the Secrets Agent

The secrets agent listens on a Unix socket at /run/ultrasushitron/secrets-agent.sock.

Terminal bash 
./target/release/secrets-agent

Start the AI Core

The core connects to the secrets agent via Unix socket and exposes a TUI for interaction.

Terminal bash 
./target/release/ultrasushitron-core

Mobile App (Optional)

The React Native/Expo app lets you approve secret requests from your phone.

Terminal bash 
cd mobile
bun install
bun start

Scan the QR code with Expo Go to pair your device. See Mobile Setup for full details.

First Agent Session

Once all components are running:

  1. Open the TUI (starts automatically with the core)
  2. Type a prompt — the agent will use tools to accomplish your task
  3. If a tool needs a secret, you'll receive an approval request on your mobile device
  4. Approve or deny — the agent continues or adapts accordingly

Next Steps