You can deploy this model and start earning money today!

AmudeeshanSrinivasan/
enma-project

Name: enma-project
Availability: InStock

Views

No views yet

ENMA

E.N.M.A. is a local-first, multi-model personal AI assistant with voice, memory, RAG, tools, symbolic routing, planning, and gated perception.

This repo is built as a modular agent system, not a simple chatbot.

Quick Start

Use Python 3.12 and the project virtual environment:

bash

cd /Users/amudeeshans/Documents/enma-project
source .venv312/bin/activate
pip install -r requirements.txt

ENMA is configured API-first. Model inference uses configured API providers, while Mac-local wake word and Apple voice runtimes stay lightweight.

Check the full local readiness state:

python run.py readiness

For machine-readable output:

python run.py readiness --json

Use the project virtual environment for validation so dependency checks reflect ENMA, not a global Python install:

bash

which python
.venv312/bin/python -m pip check
.venv312/bin/python run.py readiness --strict

Local Secrets

Keep secrets out of configs/enma.local.yaml. Use environment or Keychain references in the local config and store values outside the repo.

yaml

tools:
  web_search:
    provider: google
    google:
      api_key_env: GOOGLE_CUSTOM_SEARCH_API_KEY
      cx_env: GOOGLE_CUSTOM_SEARCH_CX

bash

export GOOGLE_CUSTOM_SEARCH_API_KEY="..."
export GOOGLE_CUSTOM_SEARCH_CX="..."

For persistent macOS Keychain storage, keep only references in local config:

yaml

tools:
  web_search:
    provider: google
    google:
      api_key_keychain:
        service: enma/google-custom-search
        account: GOOGLE_CUSTOM_SEARCH_API_KEY
      cx_keychain:
        service: enma/google-custom-search
        account: GOOGLE_CUSTOM_SEARCH_CX
      fallback_to_duckduckgo: false

Then store the values locally:

bash

security add-generic-password -U -s "enma/google-custom-search" -a "GOOGLE_CUSTOM_SEARCH_API_KEY" -w "..."
security add-generic-password -U -s "enma/google-custom-search" -a "GOOGLE_CUSTOM_SEARCH_CX" -w "..."

If a key was pasted into local config or a screenshot, rotate or restrict it in the provider console. readiness --strict checks local config hygiene and only prints redacted field paths.

Daily Commands

Chat:

python run.py chat

Voice:

python run.py voice run

Diagnostics:

bash

python run.py diagnose
python run.py voice status
python run.py rag status
python run.py tools safety
python run.py eval

Neural Schema diagnostics:

bash

python run.py schema status
python run.py schema compatibility
python run.py schema recent --limit 10
python run.py schema graph-review --limit 25
python run.py schema migration turn --from-version 1

Schema diagnostics are local and metadata-only. They summarize text/output by length, fingerprint, schema keys, and versions; they do not print raw prompts, conversation bodies, tool outputs, page bodies, audio, stdout/stderr bodies, or secret values.

Optional MCP diagnostics and reviewed local presets:

bash

python run.py mcp status
python run.py mcp doctor
python run.py mcp presets
python run.py mcp preset-check filesystem_readonly
python run.py mcp auth-check github
python run.py mcp oauth-status github
python run.py mcp stream-status remote
python run.py mcp supervision-status filesystem
python run.py mcp mutation-status
python run.py mcp preset-install filesystem_readonly --yes
python run.py mcp server-enable filesystem --yes
python run.py mcp server-disable filesystem --yes
python run.py mcp server-remove filesystem --yes

MCP stays disabled by default. Presets write only to the ignored local override file and install disabled unless --enable is passed.

Readiness helper:

scripts/check_readiness.sh

Operating Modes

Use ENMA_MODE to select a mode:

bash

ENMA_MODE=fast python run.py chat
ENMA_MODE=privacy python run.py chat
ENMA_MODE=vision python run.py perception analyze path/to/image.png --prompt "describe this screen"

Vision mode remains gated and event-driven. Normal chat does not load V-JEPA.

Local Data

ENMA keeps runtime state local:

data/enma.sqlite
data/lancedb/
data/jobs.sqlite
data/logs/
models/

Generated local data is intentionally not committed.

AmudeeshanSrinivasan/enma-project

ENMA

Quick Start

Local Secrets

Daily Commands

Operating Modes

Local Data

AmudeeshanSrinivasan/
enma-project