@askjo/camofox-browser 1.8.0 → 1.8.1

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 CHANGED
@@ -42,7 +42,7 @@ This project wraps that engine in a REST API built for agents: accessibility sna
42
42
  - **C++ Anti-Detection** - bypasses Google, Cloudflare, and most bot detection
43
43
  - **Element Refs** - stable `e1`, `e2`, `e3` identifiers for reliable interaction
44
44
  - **Token-Efficient** - accessibility snapshots are ~90% smaller than raw HTML
45
- - **Runs on Anything** - lazy browser launch + idle shutdown keeps memory at ~40MB when idle. Designed to share a box with the rest of your stack — Raspberry Pi, $5 VPS, shared Railway infra.
45
+ - **Runs on Anything** - lazy browser launch + idle shutdown keeps memory at ~40MB when idle. Designed to share a box with the rest of your stack — Raspberry Pi, $5 VPS, shared infra.
46
46
  - **Session Isolation** - separate cookies/storage per user
47
47
  - **Cookie Import** - inject Netscape-format cookie files for authenticated browsing
48
48
  - **Proxy + GeoIP** - route traffic through residential proxies with automatic locale/timezone
@@ -113,9 +113,24 @@ make up VERSION=135.0.1 RELEASE=beta.24
113
113
 
114
114
  > **⚠️ Do not run `docker build` directly.** The Dockerfile uses bind mounts to pull pre-downloaded binaries from `dist/`. Always use `make up` (or `make fetch` then `make build`) — it downloads the binaries first.
115
115
 
116
- ### Fly.io / Railway
116
+ ### Fly.io
117
117
 
118
- `railway.toml` is included. For Fly.io or other remote CI, you'll need a Dockerfile that downloads binaries at build time instead of using bind mounts — see [jo-browser](https://github.com/jo-inc/jo-browser) for an example.
118
+ For Fly.io or other remote CI, you'll need a Dockerfile that downloads binaries at build time instead of using bind mounts.
119
+
120
+ ### Railway
121
+
122
+ A `railway.toml` is included. It uses `Dockerfile.ci` (which downloads binaries at build time) and maps Railway's `PORT` env var to `CAMOFOX_PORT` automatically.
123
+
124
+ ```bash
125
+ # Install Railway CLI, then:
126
+ railway link
127
+ railway up
128
+ ```
129
+
130
+ Set secrets via the Railway dashboard or CLI:
131
+ ```bash
132
+ railway variables set CAMOFOX_API_KEY="your-generated-key"
133
+ ```
119
134
 
120
135
  ## Usage
121
136
 
@@ -252,7 +267,7 @@ curl -X POST http://localhost:9377/sessions/agent1/cookies \
252
267
  -d '{"cookies":[{"name":"foo","value":"bar","domain":"example.com","path":"/","expires":-1,"httpOnly":false,"secure":false}]}'
253
268
  ```
254
269
 
255
- #### Docker / Fly.io
270
+ #### Docker / Fly.io / Railway
256
271
 
257
272
  ```bash
258
273
  docker run -p 9377:9377 \
@@ -266,6 +281,11 @@ For Fly.io:
266
281
  fly secrets set CAMOFOX_API_KEY="your-generated-key"
267
282
  ```
268
283
 
284
+ For Railway:
285
+ ```bash
286
+ railway variables set CAMOFOX_API_KEY="your-generated-key"
287
+ ```
288
+
269
289
  ### Proxy + GeoIP
270
290
 
271
291
  Route all browser traffic through a proxy with automatic locale, timezone, and geolocation derived from the proxy's IP address via Camoufox's built-in GeoIP.
@@ -480,7 +500,7 @@ Reddit macros return JSON directly (no HTML parsing needed):
480
500
  | Variable | Description | Default |
481
501
  |----------|-------------|---------|
482
502
  | `CAMOFOX_PORT` | Server port | `9377` |
483
- | `PORT` | Server port (fallback, for platforms like Fly.io) | `9377` |
503
+ | `PORT` | Server port (fallback, for platforms like Fly.io, Railway) | `9377` |
484
504
  | `CAMOFOX_API_KEY` | Enable cookie import endpoint (disabled if unset) | - |
485
505
  | `CAMOFOX_ADMIN_KEY` | Required for `POST /stop` | - |
486
506
  | `CAMOFOX_ACCESS_KEY` | If set, all routes (except `/health`, cookie import, and `/stop`) require `Authorization: Bearer <key>`. Lets you safely expose the server beyond loopback. | - |
@@ -2,7 +2,7 @@
2
2
  "id": "camofox-browser",
3
3
  "name": "Camofox Browser",
4
4
  "description": "Anti-detection browser automation for AI agents using Camoufox (Firefox-based)",
5
- "version": "1.8.0",
5
+ "version": "1.8.1",
6
6
  "configSchema": {
7
7
  "type": "object",
8
8
  "properties": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@askjo/camofox-browser",
3
- "version": "1.8.0",
3
+ "version": "1.8.1",
4
4
  "description": "Headless browser automation server and OpenClaw plugin for AI agents - anti-detection, element refs, and session isolation",
5
5
  "type": "module",
6
6
  "main": "server.js",