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:7331with 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|codespawning paths in_sessions.py— stubbed to raiseRuntimeError
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.1only — never on a network interface - Sessions stream over loopback WebSocket; never leave your machine in transit
- Memory writes (via
neruva-recordor your own client) go to your Neruva account over HTTPS, with client-side 14-pattern secrets redaction
License
MIT — see LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file neruva_control-0.10.0-py3-none-any.whl.
File metadata
- Download URL: neruva_control-0.10.0-py3-none-any.whl
- Upload date:
- Size: 110.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
97633bdfb113e66175c751d72b339533ea598d6a6327f90dd9703147f5f4c50d
|
|
| MD5 |
e24e1fad38518562fa4df231e89325d7
|
|
| BLAKE2b-256 |
a60d5c75375bebaa39ceb8488e655f51b16c676e633643437fc2077dd06a0006
|