Install And Quick Start

1. Start Docker Desktop Or Colima

Start Docker Desktop or Colima on your Mac before using Docker sandbox execution.

2. Download And Install GeneSYS 0.4.49

mkdir -p "$HOME/genesys-release-0.4.49"
cd "$HOME/genesys-release-0.4.49"

curl -fL https://api.sigroom.com/downloads/genesys-full-0.4.49.tgz \
  -o genesys-full-0.4.49.tgz

tar -xzf genesys-full-0.4.49.tgz
cd genesys-full-0.4.49

GENESYS_INSTALL_DIR="$HOME/.gene/local-install/gene" \
GENESYS_BIN_DIR="$HOME/.gene/bin" \
./install.sh --force

export PATH="$HOME/.gene/bin:$PATH"
gene --help

3. Create A Workspace And Configure GeneSYS

• Provider/model: select your preferred provider and an available model.
• Credential: enter your provider key locally during setup.
• Sandbox: select docker.
• Memory: select file.
• Search: select duckduckgo_html if you want no additional search key.
• The full mode enables the tools and workspace writes needed to create artifacts. If configuration already exists, initialization preserves it.

mkdir -p "$HOME/Projects/genesys-workspace"
cd "$HOME/Projects/genesys-workspace"
gene init --default-backend genesys --mode full

4. Start The Local UI

Run this from your workspace, then open the Control and Threads URLs printed in the terminal. For artifact creation, try: “Create a project plan and save it as artifacts/plan.md.”

gene start --packaged-ui

Requirements

• Node.js and pnpm versions expected by the repository.
• Git for source checkouts and patch workflows.
• Docker where sandbox, browser, or trading-help workflows require containers.
• Provider keys such as OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, or OPENROUTER_API_KEY for real model runs.
• Optional web search keys for Tavily or Brave when those providers are selected during init.

From-Source Setup

pnpm install
pnpm run build
pnpm run dev
scripts/setup/install.sh

First-Run Happy Path

gene init
gene doctor --fix
gene start --open
gene login --ui
gene ask "Summarize this repo"
gene stop

First-Run Notes

• Document what gene init writes or updates, including generated config and environment files.
• Explain what happens when model provider secrets are missing.
• Show how init chooses tavily, brave, or duckduckgo_html for web search.
• Give port-conflict recovery steps and show how to start without opening a browser.
• Include detached mode when users want the runtime to survive the current shell.