The-Geek-Freaks/NEOTH

<div align="center"

<img src=".github/assets/neoth-readme-hero.svg" alt="NEOTH - your private AI buddy" width="100%"

<h1NEOTH</h1

<h3Your private AI buddy. Loyal to you. Useful everywhere.</h3

<p <strongOne memory. Three brain paths. Five memory tiers + your vault. Local-first by default.</strong </p

<p NEOTH is the personal AI system for people who want a real assistant, not a forgetful chatbot. It remembers what you approve, helps in daily life, codes seriously, connects to your tools, runs on your own machine, and leaves typed audit proof for its governed sensitive paths, with exceptions documented in the threat model. </p

<p <strongNormal user?</strong Open the GUI and talk — no YAML. &nbsp;·&nbsp; <strongPro?</strong Every claim has a CLI command that proves it. &nbsp;·&nbsp; <strongSkeptic?</strong <a href="docs/evaluation.md"15 minutes, proof on your own machine</a. </p

<p <a href="#install"<strongInstall</strong</a · <a href="#why-neoth"Why NEOTH</a · <a href="#demo-loops"Demos</a · <a href="#for-normal-users-and-pros"DAUs + Pros</a · <a href="#privacy"Privacy</a · <a href="#coding-buddy"Coding</a · <a href="#babel-index-it-predicts-its-own-collapse"Babel-Index</a · <a href="#comparison"Comparison</a · <a href="#docs"Docs</a </p

<p <a href="https://github.com/The-Geek-Freaks/NEOTH/actions" <img alt="Build" src="https://img.shields.io/github/actions/workflow/status/The-Geek-Freaks/NEOTH/ci.yml?branch=main&style=flat-square&label=build&color=00ff80&labelColor=0d0d0d" </a <a href="#privacy" <img alt="Local first" src="https://img.shields.io/badge/local--first-default-00ff80?style=flat-square&labelColor=0d0d0d" </a <a href="#coding-buddy" <img alt="Coding buddy" src="https://img.shields.io/badge/coding-canvas%2Bkanban-05d5ff?style=flat-square&labelColor=0d0d0d" </a <a href="#privacy" <img alt="Fail closed" src="https://img.shields.io/badge/fail--closed-privacy-ff2a6d?style=flat-square&labelColor=0d0d0d" </a <a href="#license" <img alt="License" src="https://img.shields.io/badge/license-MITORApache--2.0-05d5ff?style=flat-square&labelColor=0d0d0d" </a <a href="https://deepwiki.com/The-Geek-Freaks/NEOTH" <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" </a </p

</div

Install

The source tree is versioned for NEOTH 1.0.0, but no v1.0.0 release or crates.io package exists yet. The current working install path is the source checkout below. The bootstrap commands become valid only after the first compatible signed release is published; cargo install neoth --locked --features release-desktop becomes valid only after the ordered SDK + core crates.io publication completes. Until that first signed tag and publication, the neothd Rust-library API is not frozen; daemon-internal modules may still be narrowed or removed. The separately versioned neoth-plugin-sdk is the intended external extension boundary. The v1 API compatibility promise begins with the published release.

Current install (source checkout):

git clone https://github.com/The-Geek-Freaks/NEOTH
cd NEOTH
NEOTH_SRC_DIR="$PWD" bash scripts/install.sh
neoth

The all-components source installer needs Node.js 22.16+ to compile the Keet standalone. Signed desktop archives bundle it and need no Node.js.

After the first signed release, one-command install (Linux/macOS):

curl -fsSL https://raw.githubusercontent.com/The-Geek-Freaks/NEOTH/main/SRC/install.sh | bash
export PATH="$HOME/.local/bin:$PATH" # profile wiring applies automatically to new shells
neoth

The binary installer always verifies SHA-256 plus release authenticity. It uses an installed minisign with the pinned public key, an installed cosign, or downloads a temporary Cosign verifier whose platform SHA-256 is pinned to an immutable official Sigstore source commit. A clean machine therefore needs no preinstalled verifier. A downloaded verifier with the wrong digest is never executed; NEOTHALLOWUNVERIFIEDRECOVERY=1 applies only when the verifier cannot be downloaded and the archive was authenticated out of band.