Genesis on Docker

# 0. Install docker (https://www.docker.com/)

Obtain Install Script from Genesis by Contacting [email protected]

# 1. Install Genesis (one-time setup)

# 2. Start the Genesis server
~/bin/genesis_server

# 3. Open Genesis UI in your browser
# Navigate to: http://localhost:8080 (React GUI) or http://localhost:8082 (Streamlit GUI)

# 4. Connect an LLM provider from Config -> AI Providers, or with the
#    config API (see "Configuring the LLM provider" below).

# 5. Only after step 4: talk to a bot from a new terminal.
~/bin/genesis_cli "Hello, what can you help me with?"

~/bin/genesis_update              # Pull the latest container
~/bin/genesis_server              # Restart the server

Obtain Install Script from Genesis by Contacting [email protected]

genesis_server [-d] [-i image]

genesis_server                                    # Run interactively with default image
genesis_server -d                                 # Run in background
genesis_server -i genesis-back-front-dev          # Use development branch image
genesis_server -d -i genesis-back-front-dev       # Detached mode with dev image

docker build \
  --build-arg BASE_IMAGE=<your-base-image> \
  --build-arg GENESIS_COMMIT_SHA=$(git rev-parse HEAD) \
  --build-arg BUILD_TIMESTAMP=$(date -u +%Y_%m_%d_%H_%M_%S) \
  -f container/Dockerfile.app \
  -t genesis:custom .

docker build -f container/Dockerfile.app-runner -t genesis-app-runner .

docker build -f container/Dockerfile.sandbox-claude -t genesis-sandbox-claude:latest .

docker build -f container/Dockerfile.sandbox-claude \
  --build-arg CLAUDE_CODE_VERSION=1.2.3 \
  -t genesis-sandbox-claude:latest .

WEDGE_SENTINEL seq=42 uptime_s=2520.4 late_s=0.00 emit_dropped_total=0 node_psi_io_full_avg10=0.30 node_load1=2.31 gen_pid=31 gen_state=S gen_cpu_ms_delta=120 tailscaled_pid=27 tailscaled_state=S tailscaled_log_age_s=4.2 tailscaled_log_size=182734 blk=ok blk_ms=12.4 cg_cpu_throttled_us_delta=0

SQLITE_DB_PATH=/app/.genesis/db/genesis.db

# Snowflake mode (uncomment to enable):
#SNOWFLAKE_METADATA=TRUE
#SNOWFLAKE_ACCOUNT_OVERRIDE=""
#SNOWFLAKE_USER_OVERRIDE=""
#SNOWFLAKE_PASSWORD_OVERRIDE=""
#GENESIS_INTERNAL_DB_SCHEMA="XXX.YYY"

umask 077
set -o pipefail   # json.tool must not mask a failed curl
GENESIS_URL=http://localhost:8080
BODY=$(mktemp "${TMPDIR:-/tmp}/genesis-llm-body.XXXXXX.json")
CURL_CONFIG=$(mktemp "${TMPDIR:-/tmp}/genesis-curl.XXXXXX")
trap 'rm -f "$BODY" "$CURL_CONFIG"' EXIT
chmod 600 "$BODY" "$CURL_CONFIG"

# The local container runs with authentication disabled by default. With auth on,
# every call needs a bearer token for a user holding access_config_panel; read -rs
# keeps it out of shell history. Omit these lines and --config when auth is off.
read -rsp 'Genesis access token: ' GENESIS_TOKEN && echo
printf 'header = "Authorization: Bearer %s"\n' "$GENESIS_TOKEN" > "$CURL_CONFIG"
unset GENESIS_TOKEN

cat > "$BODY" <<'JSON'
{"api_key": "<openai-api-key>", "test_connection": true}
JSON
curl -sS --fail-with-body --config "$CURL_CONFIG" \
  -X POST -H 'Content-Type: application/json' --data @"$BODY" \
  "$GENESIS_URL/api/config/llm-providers/openai" | python3 -m json.tool

curl -sS --fail-with-body --config "$CURL_CONFIG" \
  -X POST -H 'Content-Type: application/json' -d '{"force": true}' \
  "$GENESIS_URL/api/config/llm-providers/openai/activate" | python3 -m json.tool

curl -sS --fail-with-body --config "$CURL_CONFIG" \
  -X PUT -H 'Content-Type: application/json' \
  -d '{"provider": "openai", "use_defaults": true, "activate_provider": true}' \
  "$GENESIS_URL/api/config/models/main/assignments" | python3 -m json.tool

genesis_cli -c                    # Display all config key/values
genesis_cli -c <key> <value>      # Set config value

genesis_cli -c server_url snowflake://user@domain:pass@account/database/app

mcp_bridge <mcp_server_command> [args...]

# Add filesystem access tools
mcp_bridge npx -y @modelcontextprotocol/server-filesystem /tmp

# Add custom MCP server tools
mcp_bridge python my_mcp_server.py --config config.json

# Add database access tools
mcp_bridge npx -y @modelcontextprotocol/server-sqlite /path/to/database.db

$ genesis_cli -t new
switched to Eve/completion_thread_154d87de-a40d-493e-b5e1-c4a42f7e0db6: New Chat

$ genesis_cli "list bots"
[Bot list output...]

$ genesis_cli \!manage_todos action=LIST, for_bot_id="DEng-DBT-EngineerBot"
{
    "success": true,
    "todos": [...]
}

genesis_update [-i image]

genesis_update                              # Update default genesis image
genesis_update -i genesis-back-front-dev    # Update development branch image