Skip to main content

Local loopback daemon for the Neruva substrate. Maintenance-only as of v0.10.0 -- the screen-control (Neruva Computer) and code-editing (Neruva Code) agents were retired in the 2026-05-18 substrate-first pivot and archived to _attic/. For new installs use neruva-mcp (Claude Code / Cursor / any MCP agent) or neruva-record (auto-record Claude Code sessions). The daemon still binds to 127.0.0.1:7331 with auth-token gating for users who want to host a local control plane for custom agents on the substrate.

Project description

neruva-control

Status (v0.10.0+, 2026-05-18): Maintenance-only. Original role — running Neruva Computer and Neruva Code agents on your laptop — was retired in the 2026-05-18 substrate-first pivot. The Cockpit chat UI moved to neruva.io/cockpit as a hosted Memory Inspector. For new installs, see neruva-mcp + neruva-record.

This daemon used to drive two on-device agents (screen control + code editing) from the Neruva Cockpit web UI. Both agents were archived to _attic/ in this release; the daemon survives as a small loopback service for users who still want to host a local control plane for custom agent harnesses they build on the Neruva substrate.

If you don't have a specific need for neruva-control, you almost certainly want one of these instead:

You want Install
Persistent memory in Claude Code / Cursor / any MCP agent pip install neruva-mcp — or use @neruva/mcp on npm
Auto-record every Claude Code session to your Neruva memory pip install neruva-record && neruva-record-install
Browse / query / replay records in a web UI https://neruva.io/cockpit (hosted, no install)
Raw REST against the substrate curl https://api.neruva.io/v1/records/ingest -H "Api-Key: ..."

What's still here

  • A FastAPI process bound to 127.0.0.1:7331 with auth-token gating
  • A session model + WebSocket stream you can wire your own agent into
  • Project / file-tree / wallet endpoints used by neruva-record's hook flow

What was removed in v0.10.0

  • _agent.py (Neruva Computer agent loop) → _attic/_agent.py
  • _code_agent.py (Neruva Code agent loop) → _attic/_code_agent.py
  • _browser.py, _axtree.py, _ocr.py, _skills.py, _repo_map.py, _lsp.py, _indexer.py, _tool_catalog.py → all _attic/
  • Optional-dep extras [agent] (pyautogui / pillow / playwright / pyright / pytesseract / pygetwindow / uiautomation) — no longer needed
  • All agent_type=computer|code spawning paths in _sessions.py — stubbed to raise RuntimeError

The full file history lives in _attic/ if you need to lift anything out.

Install

pip install neruva-control
neruva-control-install

Privacy

  • Daemon listens on 127.0.0.1 only — never on a network interface
  • Sessions stream over loopback WebSocket; never leave your machine in transit
  • Memory writes (via neruva-record or your own client) go to your Neruva account over HTTPS, with client-side 14-pattern secrets redaction

License

MIT — see LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

neruva_control-0.10.1.tar.gz (43.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

neruva_control-0.10.1-py3-none-any.whl (47.6 kB view details)

Uploaded Python 3

File details

Details for the file neruva_control-0.10.1.tar.gz.

File metadata

  • Download URL: neruva_control-0.10.1.tar.gz
  • Upload date:
  • Size: 43.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for neruva_control-0.10.1.tar.gz
Algorithm Hash digest
SHA256 fb64e71e7f9ce5cb7325dff99e483589abdd8bd69495ddcd859b69ba3c9a2cf6
MD5 d9ea20de59eb1fdf7cbeb1d76558e318
BLAKE2b-256 1c8fdb9386787aabba7c1f5f9133cf1792f97d58fd23fdd8471befa19fffda3e

See more details on using hashes here.

File details

Details for the file neruva_control-0.10.1-py3-none-any.whl.

File metadata

File hashes

Hashes for neruva_control-0.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bb4cce9e514661b120314f9ae17992271d3470fa8dc92399c03ab2618c9ca513
MD5 56352fed3be94b9c5d638f3ec601a264
BLAKE2b-256 117193018e9c8ee4a0e59f51943b8a4d2f210579e9c167d8b586df2a0364e90c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page