# script install
curl -fsSL https://raw.githubusercontent.com/versperai/VersperClaw/main/install.sh | bash

# source install
git clone https://github.com/versperai/VersperClaw.git && cd VersperClaw && bun install && bun run build:dev:full && ./VersperClaw 

# if want global use bin file
cp VersperClaw ~/.local/bin
# then can use VersperClaw in everywhere after /login

# Maximum_Context_Window = min(CLAUDE_CODE_MAX_CONTEXT_TOKENS, CLAUDE_CODE_AUTO_COMPACT_WINDOW) - 20000
# set 200k env in ~/.claude/settings.json or terminal
# the 20k is used to compact as buffer band
{
  "env": {
    "USER_TYPE": "ant",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "200000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "200000"
  }
}

# set auto-dream config
nvim ~/.claude/settings.json

{
  "autoMemoryEnabled": true,
  "autoDreamEnabled": true
}

# local config search engine - searxng in archlinux
# make sure have install docker and docker-compose
sudo pacman -S docker-compose && docker
docker --version && docker compose version
sudo usermod -aG docker $USER

# make sure open pc and now start docker daemon
sudo systemctl enable --now docker

# or install searxng in docker-compose by yourself
curl -fsSL \
  -O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
  -O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example

# add json source in formats behind html - jsonl in 87 lines
cd searxng/core-config/ && sudo nvim settings.yml

# start searxng engine
docker compose up -d

# check in every browser
firefox http://localhost:8080

# set tool_search env in ~/.claude/settings.json
{
  "env": {
    "ENABLE_TOOL_SEARCH": "true"
  }
}
# or allow tool search in ~/.bashrc
export ENABLE_TOOL_SEARCH=true

# On startup, the CLI runs silently in the background, maintains a persistent Telegram connection, and listens for messages.
# start VersperClaw Cli
./VersperClaw

# enter it into the cli input field and interactive configuration parameters
/telegram

# telegram, wechat and whatsapp
versper setup gateway

# then start listen
versper gateway

# Source install
git clone -b dev/python https://github.com/versperai/VersperClaw.git

# If you want check out the have been legacyed python version code, just switch to the dev/python branch

# make sure you have installed uv and creat .venv via uv venv
uv pip install -r requirements.txt # or uv sync
source .venv/bin/activate
uv pip install -e .

# use codex, openrouter, or claude remote model via api
versper setup

# if use vllm or llama.cpp in local model for inference 
# for example use llama.cpp
llama-server \
  --model unsloth/Qwen3.5-4B-GGUF/Qwen3.5-4B-UD-Q4_K_XL.gguf \
  --mmproj unsloth/Qwen3.5-4B-GGUF/mmproj-F16.gguf \
  --seed 3407 \
  --temp 1.0 \
  --top-p 0.95 \
  --min-p 0.01 \
  --top-k 40 \
  -c 49152 \
  --port 8001 \
  --chat-template-kwargs '{"enable_thinking":true}' \
  --host 0.0.0.0

# check model name and pass inference
curl http://localhost:8001/v1/models

curl http://localhost:8001/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen",
    "messages": [
      {"role": "user", "content": "hello"}
    ]
  }'

cd ~/.versper && nvim config.yaml
# model:
#  api_key: sk-no-key-required
#  base_url: http://localhost:8001/v1
#  default: unsloth/Qwen3.5-4B-GGUF
#  provider: custom

versper doctor # make sure all checks passed

if ban mcp in ~/.versper/.env:
export VERSPER_BROWSER_USE_MCP=0

# live chrome control
npm install -g chrome-devtools-mcp@latest
npm install -g agent-browser@latest

# make sure you have installed chrome
google-chrome-stable

# fill it in the search bar and click the box
chrome://inspect/#remote-debugging

# check chrome connect
versper
/browser status