Deposit raw, curate quietly, retrieve at the right moment.
The living knowledge layer for an agent's environment (CLI, IDE, framework). Companion to Conscio, which minds the agent itself; Neurata minds the agent's world: skills, tools, docs, decisions — catalogued, curated, retrievable.
Install
pip install neurata # or: pipx install neurata
From source, for hacking on it:
git clone https://github.com/Neguiolidas/Neurata
python3 -m venv ~/.venvs/neurata
~/.venvs/neurata/bin/pip install -e ./Neurata
ln -sf ~/.venvs/neurata/bin/neurata ~/.local/bin/neurata # if ~/.local/bin is on PATH
Zero runtime deps. The archive lives in ~/.neurata (override with
NEURATA_HOME). neu is installed alongside neurata as a typing
convenience — docs always use neurata.
Use
# deposit (stdin via '-', or positional text)
echo "raw content" | neurata deposit -
neurata deposit "raw content" --title "Note"
# catalogue the inbox (mechanical, reversible — nothing is destroyed)
neurata tick
# query (deterministic lexical)
neurata query "term"
neurata query "term regime:curated" # facet: what the archive owns
# (regime:mirror = synced from a source)
neurata expand <id> # card → summary → full
# archive health
neurata doctor
neurata --version
Automatic curation
tick catalogues whatever is in the inbox. Run it hourly via cron:
0 * * * * $HOME/.local/bin/neurata tick >> $HOME/.neurata/logs/cron-tick.log 2>&1
neurata doctor warns (last-tick) if the cron stops.
Principles
- Files are the truth (a valid Obsidian vault); the index is a disposable cache.
- Deterministic retrieval first; LLMs only where explicitly wanted.
- Nothing is ever destroyed: archive + quarantine, never delete.
- Zero runtime dependencies. Python ≥ 3.10.
Status: v1.0.0. The 1.0 gate was dogfooding, not a version number:
neurata doctor measures it, and it cleared at 12 distinct days of real
use inside a 14-day window.
License: AGPL-3.0-or-later.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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 neurata-1.0.0.tar.gz.
File metadata
- Download URL: neurata-1.0.0.tar.gz
- Upload date:
- Size: 138.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
18fed58d4009a07eb06c67f50602aab3358a0631b9fcca6c1241afd87f068134
|
|
| MD5 |
ed0d41d68bb98bcf6fef9d5b6d8d42da
|
|
| BLAKE2b-256 |
f6a859e220a97d428f799b45c3a068f2568e434fdb2d93dda25add06d7dc8c07
|
Provenance
The following attestation bundles were made for neurata-1.0.0.tar.gz:
Publisher:
release.yml on Neguiolidas/Neurata
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
neurata-1.0.0.tar.gz -
Subject digest:
18fed58d4009a07eb06c67f50602aab3358a0631b9fcca6c1241afd87f068134 - Sigstore transparency entry: 2422083884
- Sigstore integration time:
-
Permalink:
Neguiolidas/Neurata@2e78ddf211eacfeca8404329108922c52f0aaeb1 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/Neguiolidas
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@2e78ddf211eacfeca8404329108922c52f0aaeb1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file neurata-1.0.0-py3-none-any.whl.
File metadata
- Download URL: neurata-1.0.0-py3-none-any.whl
- Upload date:
- Size: 90.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6e84f165445696e1ec138c2e411faec0e3a6fdc87651acae441a21bf3fdec841
|
|
| MD5 |
8317e47256d575571416c1a6f4618773
|
|
| BLAKE2b-256 |
fbf5ca7bf336871f6f12f8913263e2e37c5786e4a7eb9e75f2180f7a142f27b6
|
Provenance
The following attestation bundles were made for neurata-1.0.0-py3-none-any.whl:
Publisher:
release.yml on Neguiolidas/Neurata
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
neurata-1.0.0-py3-none-any.whl -
Subject digest:
6e84f165445696e1ec138c2e411faec0e3a6fdc87651acae441a21bf3fdec841 - Sigstore transparency entry: 2422083930
- Sigstore integration time:
-
Permalink:
Neguiolidas/Neurata@2e78ddf211eacfeca8404329108922c52f0aaeb1 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/Neguiolidas
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@2e78ddf211eacfeca8404329108922c52f0aaeb1 -
Trigger Event:
push
-
Statement type:
