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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

neruva_control-0.10.0-py3-none-any.whl (110.0 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for neruva_control-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 97633bdfb113e66175c751d72b339533ea598d6a6327f90dd9703147f5f4c50d
MD5 e24e1fad38518562fa4df231e89325d7
BLAKE2b-256 a60d5c75375bebaa39ceb8488e655f51b16c676e633643437fc2077dd06a0006

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