@xynogen/pix-9router 0.2.2 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# pix-9router
|
|
2
2
|
|
|
3
|
-
Pi coding agent extension — **9Router provider** + **fetch** and **
|
|
3
|
+
Pi coding agent extension — **9Router provider** + **fetch**, **search**, and **transcribe** tools backed by an internal OpenAI-compatible router API.
|
|
4
4
|
|
|
5
5
|
## What's included
|
|
6
6
|
|
|
@@ -9,11 +9,12 @@ Pi coding agent extension — **9Router provider** + **fetch** and **search** to
|
|
|
9
9
|
| `provider` | provider | Registers `9router` provider with live model list from the router API |
|
|
10
10
|
| `fetch` | tool | `fetch(url, format, max_characters?)` — fetches web pages via exa through the router, falls back to curl |
|
|
11
11
|
| `search` | tool | `search(query, search_type, max_results?)` — web/news search via exa through the router, falls back to curl |
|
|
12
|
+
| `transcribe` | tool | `transcribe(file, model?, language?)` — speech-to-text via `/audio/transcriptions` endpoint (default: `dg/nova-3`), falls back to curl |
|
|
12
13
|
|
|
13
14
|
## Install
|
|
14
15
|
|
|
15
16
|
```bash
|
|
16
|
-
pi install
|
|
17
|
+
pi install npm:@xynogen/pix-9router
|
|
17
18
|
```
|
|
18
19
|
|
|
19
20
|
## Environment
|
|
@@ -32,8 +33,17 @@ export ROUTER_API_KEY="your-key-here"
|
|
|
32
33
|
|
|
33
34
|
## How it works
|
|
34
35
|
|
|
35
|
-
- **Provider**: on load, fetches `/models` from the router and registers them with Pi. [models.dev](https://models.dev/api.json) is used internally to fill missing context window / modality fields where the router response omits them. Model list is cached at `~/.cache/pi/9router.json` (TTL
|
|
36
|
-
- **fetch / search**: POST to `/web/fetch` and `/search` on the router (which proxies to exa). If the router is unreachable, falls back to raw `curl`.
|
|
36
|
+
- **Provider**: on load, fetches `/models` from the router and registers them with Pi. [models.dev](https://models.dev/api.json) is used internally to fill missing context window / modality fields where the router response omits them. Model list is cached at `~/.cache/pi/9router.json` (TTL 30 min).
|
|
37
|
+
- **fetch / search**: POST to `/web/fetch` and `/search` on the router (which proxies to exa). If the router is unreachable, falls back to raw `curl`. Tool output is rendered dimmed so fetched web content reads like faded context rather than primary output.
|
|
38
|
+
- **transcribe**: POST to `/audio/transcriptions` (Deepgram Nova 3 by default). Accepts any audio file path; falls back to curl.
|
|
39
|
+
|
|
40
|
+
## Full distro
|
|
41
|
+
|
|
42
|
+
To install the complete pix suite (all packages + Pi itself):
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
|
|
46
|
+
```
|
|
37
47
|
|
|
38
48
|
## License
|
|
39
49
|
|