https://github.com/agentstation/neovex
https://github.com/agentstation/neovex
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/agentstation/neovex
- Owner: agentstation
- License: other
- Created: 2026-03-28T21:03:55.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-08T07:24:25.000Z (2 months ago)
- Last Synced: 2026-04-08T08:30:31.501Z (2 months ago)
- Language: Rust
- Size: 30.8 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# neovex
[](https://github.com/agentstation/neovex/actions/workflows/ci.yml)
[](https://codecov.io/gh/agentstation/neovex)
[](https://github.com/agentstation/neovex/releases/latest)
[](https://github.com/agentstation/homebrew-tap)
Self-hosted JavaScript backend runtime powered by V8.
Neovex combines tenant-isolated embedded storage, native HTTP and WebSocket
APIs, scheduled work, and an optional Convex compatibility surface in a single
Rust binary.
## What It Does
- tenant-isolated document storage with optional per-table schemas
- document CRUD, explicit queries, and paginated queries over HTTP
- live query subscriptions over WebSocket
- durable scheduled mutations and recurring cron jobs
- an optional V8 runtime and in-repo Convex compatibility layer
## Install
### Homebrew (macOS and Linux)
```bash
brew install agentstation/tap/neovex
```
Homebrew automatically verifies the SHA256 checksum of the downloaded archive.
On Apple Silicon macOS, the cask owns the machine helper contract:
`slp/krunkit/krunkit` is the explicit VM dependency and `gvproxy` ships inside
the Neovex archive under `libexec/gvproxy`.
### Download binary
Download the latest release for your platform from [GitHub Releases](https://github.com/agentstation/neovex/releases/latest).
| Platform | Architecture | Archive |
|----------|-------------|---------|
| Linux | x86_64 | `neovex_linux_x86_64.tar.gz` |
| Linux | ARM64 | `neovex_linux_arm64.tar.gz` |
| macOS | Apple Silicon | `neovex_darwin_arm64.tar.gz` |
| Windows | x86_64 | `neovex_windows_x86_64.zip` |
On macOS, the darwin archive already contains the bundled `libexec/gvproxy`
helper. There is no separate Neovex `gvproxy` download.
```bash
# Example: download and install on macOS Apple Silicon
# Homebrew is the recommended path. If you install from the tarball directly,
# preserve the bundled libexec layout so machine helper discovery still works.
curl -LO https://github.com/agentstation/neovex/releases/latest/download/neovex_darwin_arm64.tar.gz
tar xzf neovex_darwin_arm64.tar.gz
sudo mkdir -p /opt/neovex/bin /opt/neovex/libexec
sudo install -m 0755 neovex /opt/neovex/bin/neovex
sudo install -m 0755 libexec/gvproxy /opt/neovex/libexec/gvproxy
sudo ln -sf /opt/neovex/bin/neovex /usr/local/bin/neovex
```
Do not move only the `neovex` binary on macOS. The supported machine contract
expects the bundled helper layout to stay intact beside the installed binary,
or to be provided explicitly through `NEOVEX_MACHINE_HELPER_BINARY_DIR`.
### Build from source
Requires [Rust](https://rustup.rs/) stable toolchain.
```bash
git clone https://github.com/agentstation/neovex.git
cd neovex
cargo install --path crates/neovex-bin
```
## Verify
Every release includes SHA256 checksums and [build provenance attestations](https://docs.github.com/en/actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds) signed via [Sigstore](https://www.sigstore.dev/). These provide cryptographic proof that each binary was built by our GitHub Actions CI from this repository's source code.
For local repo verification, prefer the checked-in entrypoints such as
`make test`, `make clippy`, `make check`, and the verification-harness scripts.
They are guarded with a small single-flight wrapper so accidentally launching
the same long-running verification command twice exits quickly instead of
starting another full local run.
### Checksum verification
Each release includes a `checksums-sha256.txt` file:
```bash
# Download the binary and checksums
curl -LO https://github.com/agentstation/neovex/releases/latest/download/neovex_darwin_arm64.tar.gz
curl -LO https://github.com/agentstation/neovex/releases/latest/download/checksums-sha256.txt
# Verify
sha256sum --check --ignore-missing checksums-sha256.txt
```
On macOS, use `shasum -a 256 --check` instead of `sha256sum`.
### Build provenance attestation
Verify that a binary was built by GitHub Actions from this repository:
```bash
gh attestation verify neovex_darwin_arm64.tar.gz --owner agentstation
```
This checks the Sigstore-signed attestation against the [GitHub attestation ledger](https://github.com/agentstation/neovex/attestations). It confirms the exact workflow, commit, and runner that produced the artifact. Requires the [GitHub CLI](https://cli.github.com/).
## Licensing
- source-available under the [Neovex Community License](LICENSE)
- plain-English summary in [LICENSING.md](LICENSING.md)
- commercial terms overview in [COMMERCIAL.md](COMMERCIAL.md)
- contributor policy in [CONTRIBUTING.md](CONTRIBUTING.md)
- optional runtime license loading via `--license-file`, `NEOVEX_LICENSE_FILE`, or `./.neovex/license.json`
- current in-product license status exposed at `GET /debug/license/status`
## Docs
- [Documentation index](docs/README.md)
- [Architecture](ARCHITECTURE.md)
- [Current capabilities](docs/reference/current-capabilities.md)
- [HTTP and WebSocket API](docs/reference/http-api.md)
- [CLI reference](docs/reference/cli.md)
- [Convex compatibility](docs/convex/compatibility.md)
- [Demos](demos/README.md)
- [Plans index](docs/plans/README.md) for active execution control planes,
deferred design work, and archived history