ANONYMOUS · free console API
Every route the page at /anonymous
uses, in the order it uses them. One session is one VM: it is created by
POST /session, kept alive by the page's heartbeat, and deleted by
POST /session/{id}/close — which the page sends with
navigator.sendBeacon the moment it is closed, reloaded or left.
Nothing about a session survives: not the workspace, not the conversation.
18+ · your target, your responsibility. The console works one host at a time -
the one you type into the field - and runs the platform's whole Kali toolbelt
against it, active probes included, plus the sandboxed Python runner.
Developer wallet — the subscription and the API key live on one wallet,
and that wallet lives on the API platform: no email, no password, the address
is the account. Sign one in (or generate one) on the ANONYMOUS API documents,
subscribe there, and every key minted from it inherits the subscription and is
bound to that address. This free console needs no wallet — it is one visitor,
one ephemeral VM — but a developer key is what you keep when you leave.
Routes
| Route | What it does |
|---|---|
GET /api/anonymous |
What this deployment offers: whether the console is enabled, whether a model is configured, the session ceiling, the idle TTL, the turn cap (0 = none), the toolbelt it runs, and the path of this page. |
POST /api/anonymous/session |
START VM. Creates the VM and its workspace and returns
{session:{id, target, mode, turnsLeft, ttlSeconds, …}}.
429 when the deployment is at its session ceiling. |
GET /api/anonymous/session/{id} |
The session header: target, mode, turns used and left, age, idle time. |
POST /api/anonymous/session/{id}/heartbeat |
“The page is still open.” Sent every 20 s; a VM whose heartbeat stops is deleted by the sweeper (default idle TTL 900 s). 404 once the VM is gone. |
POST /api/anonymous/session/{id}/close |
Delete the VM and every byte of its workspace. The page sends it on
pagehide, so closing, reloading or navigating away ends it. |
POST /api/anonymous/session/{id}/target |
The field at the top: body {"target": "lab.example.com", "mode": "recon"}.
Accepts a host, an IPv4 address, a CIDR block or an http(s) URL, and answers
422 with the reason otherwise. Active probes are downgraded to
recon unless the deployment opened them. |
GET /api/anonymous/session/{id}/screen?since= |
The VM screen: every row after since — info,
target, user, tool, result,
refused, answer, error — with its clock,
plus the session header. |
POST /api/anonymous/session/{id}/chat |
The conversation. Body {"message": "…"}, answered as
text/event-stream (below). 409 while a turn is still running,
429 when the VM used its turns, 404 when the VM is gone, 503 when no model
is configured on the deployment. |
GET /anonymous |
The console itself. /chat — the old Security AI chatbox — now
redirects here with a 307. |
The chat stream
POST …/chat answers with Server-Sent Events, one JSON object per
data: frame:
| Event | Meaning |
|---|---|
status | The turn started (the session header rides along). |
token | Answer text, as it is generated — append it. |
tool_call | The crew is running a probe: {tool, args, detail}. |
tool_result | What that probe returned: {tool, ok, output}. |
tool_refused | A step was refused (the sandbox or the VM said no), and why. |
error | The model could not answer; {message}. |
done | The turn is over; the session header is repeated. |
A whole session with curl
: start the VM and keep its id
SID=$(curl -s -X POST https://www.onenesstech.ca/api/anonymous/session \
| python -c "import sys,json;print(json.load(sys.stdin)['session']['id'])")
: name the one host this VM works on
curl -s -X POST https://www.onenesstech.ca/api/anonymous/session/$SID/target \
-H 'Content-Type: application/json' \
-d '{"target":"scanme.nmap.org","mode":"recon"}'
: talk to ANONYMOUS (the stream is the answer)
curl -sN -X POST https://www.onenesstech.ca/api/anonymous/session/$SID/chat \
-H 'Content-Type: application/json' \
-d '{"message":"what is this host running, and does the certificate look right?"}'
: read the VM screen from the top
curl -s "https://www.onenesstech.ca/api/anonymous/session/$SID/screen?since=0"
: keep it alive while you work (every 20 s), then delete it
curl -s -X POST https://www.onenesstech.ca/api/anonymous/session/$SID/heartbeat
curl -s -X POST https://www.onenesstech.ca/api/anonymous/session/$SID/close
What the free console is not
- No commands: the input is a conversation. There is no shell, no syntax and no order words — ANONYMOUS decides which probe answers your question.
- No uploads, no app studio, no downloads, no audio. Those live in the paid ANONYMOUS products, which run a full VM on your own machine.
- No accounts and no history: the VM, its workspace and the conversation are deleted when the page goes away, and the sweeper deletes anything whose heartbeat stopped.
- One turn at a time per VM, a per-address rate limit, and one target — the host in the field.
Configuration (operators)
| Variable | Default | Meaning |
|---|---|---|
ANONYMOUS_ENABLED | 1 | Serve the console and its API at all. |
ANONYMOUS_SESSIONS | 6 | VMs at once, across every visitor. |
ANONYMOUS_SESSION_TTL_SECONDS | 900 | Idle seconds before the sweeper deletes a VM. |
ANONYMOUS_WORKSPACE | ./data/anonymous | Where the per-session workspaces live (and are deleted from). |
ANONYMOUS_CHAT_PER_MINUTE | 12 | Chat rate limit per address. |
ANONYMOUS_MAX_TURNS | 0 | Turns one VM is allowed (0 = no cap). |
ANONYMOUS_ALLOW_ACTIVE_TOOLS | 1 | Run the whole Kali toolbelt, active probes included. Set 0 for read-only probes only. |