# Noa · נועה

A phone-first Hebrew voice companion. You send voice notes and she answers in her own voice, remembers what you tell her, and the conversation builds over time.

**Status:** Private · Agents · 2026

- **Local checkout:** `/Users/simon/Developer/noa-gpu` (branch `main`)
- **Repository:** https://github.com/ShimonNavon/noa
- **On another machine:** `git clone https://github.com/ShimonNavon/noa` — the paths below are Simon's Mac
- **Live:** https://noa.navonsimon.com/
- **Where it runs:** ubuntu01 Docker · shared edge network · Cloudflare tunnel

## Stack

Python, FastAPI, SQLite, OpenRouter, ElevenLabs, Docker, Cloudflare tunnel

## Start here

- `app/persona.py` — Hebrew system prompt, intensity levels, example exchanges
- `app/session.py` — 90-minute session gaps, calibration, heat ladder
- `app/static/` — RTL PWA: hold-to-record, voice bubbles, settings sheet
- `deploy/install_local.sh` — self-hosted-runner deploy path
- `deploy/nginx-noa.conf` — edge site config

## Commands

- **Run locally:** `python3 -m venv .venv && .venv/bin/pip install -r requirements.txt -r requirements-dev.txt && .venv/bin/uvicorn app.main:app --reload`
- **Tests:** `.venv/bin/python -m pytest -q`

## Deploy and where it runs

- Runs on ubuntu01 in Docker on the shared edge network (cloudflared -> nginx -> noa-app).
- Production https://noa.navonsimon.com from main; test https://noa-test.navonsimon.com from test.
- Pushing runs GitHub tests, then the self-hosted runner rsyncs to /srv/noa[-test], rebuilds and restarts.

## Current state

Live and private. Production follows main; test follows the test branch.

## Watch out

- Secrets live only in /srv/noa*/.env on the server, never in the repo.
- This is an adult, consensual companion persona with explicit intensity levels; treat it as private personal work.
- Mic capture needs a secure context; localhost is fine, plain HTTP over the LAN is not.
- Session calibration and the heat ladder are deliberate pacing rules; do not let a single reply jump levels.

## Secrets — locations only, never print values

- /srv/noa/.env and /srv/noa-test/.env on ubuntu01.

## Tags

FastAPI, ElevenLabs, Memory

---

Brief generated 2026-11-08 from `~/Developer/my-projects/context/`. Canonical URL: https://projects.navonsimon.com/context/noa.md
