chenbhao commited on
Commit
a47504b
·
1 Parent(s): dc82e5e

chore: explain typescript main branch and legacy dev/python branch

Browse files
Files changed (1) hide show
  1. README.md +115 -4
README.md CHANGED
@@ -11,13 +11,13 @@
11
  curl -fsSL https://raw.githubusercontent.com/versperai/VersperClaw/main/install.sh | bash
12
 
13
  # source install
14
- git clone https://github.com/versperai/VersperClaw && cd VersperClaw && bun install && bun run build:dev:full && ./cli-dev
15
  ```
16
 
17
- ## WebSearch && WebFetch Tools
18
 
19
  ```bash
20
- # config search engine - searxng in archlinux
21
  # make sure have install docker and docker-compose
22
  sudo pacman -S docker-compose && docker
23
  docker --version && docker compose version
@@ -41,7 +41,7 @@ docker compose up -d
41
  firefox http://localhost:8080
42
  ```
43
 
44
- ## Telegram
45
 
46
  ```bash
47
  # On startup, the CLI runs silently in the background, maintains a persistent Telegram connection, and listens for messages.
@@ -51,3 +51,114 @@ firefox http://localhost:8080
51
  # enter it into the cli input field and interactive configuration parameters
52
  /telegram
53
  ```
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  curl -fsSL https://raw.githubusercontent.com/versperai/VersperClaw/main/install.sh | bash
12
 
13
  # source install
14
+ git clone https://github.com/versperai/VersperClaw.git && cd VersperClaw && bun install && bun run build:dev:full && ./cli-dev
15
  ```
16
 
17
+ ## WebSearch && WebFetch Tools - 100% free
18
 
19
  ```bash
20
+ # local config search engine - searxng in archlinux
21
  # make sure have install docker and docker-compose
22
  sudo pacman -S docker-compose && docker
23
  docker --version && docker compose version
 
41
  firefox http://localhost:8080
42
  ```
43
 
44
+ ## Telegram - Interactive Config
45
 
46
  ```bash
47
  # On startup, the CLI runs silently in the background, maintains a persistent Telegram connection, and listens for messages.
 
51
  # enter it into the cli input field and interactive configuration parameters
52
  /telegram
53
  ```
54
+
55
+ # Legacy Python Version
56
+
57
+ ### Demos dev/python
58
+
59
+ #### 1.Auto Scientific Research & evolve code experiment and write AI ccf/sci draft paper also support checkpoint
60
+
61
+ <p align="center">
62
+ <img src="assets/legacy/paper.gif" height="250"/>
63
+ <img src="assets/legacy/versper.gif" height="250"/>
64
+ </p
65
+
66
+ #### 2.Web Search
67
+
68
+ ![versperclaw_weather](assets/legacy/versperclaw1.jpg)
69
+
70
+ #### 3.Deep Search
71
+
72
+ ![versperclaw_weather](assets/legacy/versperclaw2.jpg)
73
+
74
+ #### 4.Live Chrome Control
75
+
76
+ ![control_browser_use_gemini](assets/legacy/control_browser_use_gemini.jpg)
77
+
78
+ #### 5.Gateway - WeXin, Telegram and so on
79
+
80
+ ```bash
81
+ # telegram, wechat and whatsapp
82
+ versper setup gateway
83
+
84
+ # then start listen
85
+ versper gateway
86
+ ```
87
+
88
+ ```bash
89
+ # Source install
90
+ git clone -b dev/python https://github.com/versperai/VersperClaw.git
91
+
92
+ # If you want check out the have been legacyed python version code, just switch to the dev/python branch
93
+
94
+ # make sure you have installed uv and creat .venv via uv venv
95
+ uv pip install -r requirements.txt # or uv sync
96
+ source .venv/bin/activate
97
+ uv pip install -e .
98
+
99
+ # use codex, openrouter, or claude remote model via api
100
+ versper setup
101
+ ```
102
+
103
+ ```bash
104
+ # if use vllm or llama.cpp in local model for inference
105
+ # for example use llama.cpp
106
+ llama-server \
107
+ --model unsloth/Qwen3.5-4B-GGUF/Qwen3.5-4B-UD-Q4_K_XL.gguf \
108
+ --mmproj unsloth/Qwen3.5-4B-GGUF/mmproj-F16.gguf \
109
+ --seed 3407 \
110
+ --temp 1.0 \
111
+ --top-p 0.95 \
112
+ --min-p 0.01 \
113
+ --top-k 40 \
114
+ -c 49152 \
115
+ --port 8001 \
116
+ --chat-template-kwargs '{"enable_thinking":true}' \
117
+ --host 0.0.0.0
118
+
119
+ # check model name and pass inference
120
+ curl http://localhost:8001/v1/models
121
+
122
+ curl http://localhost:8001/v1/chat/completions \
123
+ -H "Content-Type: application/json" \
124
+ -d '{
125
+ "model": "qwen",
126
+ "messages": [
127
+ {"role": "user", "content": "hello"}
128
+ ]
129
+ }'
130
+
131
+ cd ~/.versper && nvim config.yaml
132
+ # model:
133
+ # api_key: sk-no-key-required
134
+ # base_url: http://localhost:8001/v1
135
+ # default: unsloth/Qwen3.5-4B-GGUF
136
+ # provider: custom
137
+ ```
138
+
139
+ ```bash
140
+ versper doctor # make sure all checks passed
141
+ ```
142
+
143
+ ## Add-on
144
+
145
+ ```bash
146
+ if ban mcp in ~/.versper/.env:
147
+ export VERSPER_BROWSER_USE_MCP=0
148
+ ```
149
+
150
+ ```bash
151
+ # live chrome control
152
+ npm install -g chrome-devtools-mcp@latest
153
+ npm install -g agent-browser@latest
154
+
155
+ # make sure you have installed chrome
156
+ google-chrome-stable
157
+
158
+ # fill it in the search bar and click the box
159
+ chrome://inspect/#remote-debugging
160
+
161
+ # check chrome connect
162
+ versper
163
+ /browser status
164
+ ```