Skip to content

Tamok/wymber

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wymber

A private, local-first space to map and understand your experiences.

Wymber is a privacy-first, trauma-informed tool for gently laying out what happened, how it connects, and how you're growing — at your own pace, on your own device. It's an active revival (alpha), open-sourced so its privacy claims can be independently verified.

🌐 wymber.app · 📐 Architecture decisions · ⚖️ AGPL-3.0

Self-help, not medical care. Wymber is a tool for personal reflection — not therapy, diagnosis, or a medical device, and not a substitute for professional care. If you're in crisis, see Crisis resources.

What it is

  • Local-first & private. Your map lives on your device, encrypted with a key derived from your password. There's no account to create and nothing sent to a server. A printable recovery sheet means a forgotten password no longer costs you your data. See ADR-0001.
  • A map, not a form. Eight gentle building blocks — Event, Emotion, Person, Place, Trigger, Coping, Insight, Growth — connect into a web you can explore. A discovery engine is planned to gently surface links you might not have seen yet.
  • Trauma-informed by design. Soft colours, gentle language, predictable UI, no jarring motion, full keyboard navigation, and WCAG 2.1 AA accessibility as a baseline.

Status — active alpha. The local-first encrypted-vault client is rolling out (crypto + storage foundation merged; the UI is being wired up). The FastAPI backend remains for self-hosting and an optional, future, zero-knowledge sync.

How it's built

  • Frontend — vanilla JS + ES modules, no build step.
  • Crypto — envelope encryption (a random AES-256-GCM data key, wrapped per unlock method: password, recovery code, later passkeys); PBKDF2 today, Argon2id tracked.
  • Backend (optional / self-host) — a tiny FastAPI app that only serves the static files (and is where an optional, future, zero-knowledge sync endpoint would live). No database, no accounts.

Run it (development)

python -m venv .venv
# Windows: .venv\Scripts\activate    |    macOS/Linux: source .venv/bin/activate
pip install -r requirements.lock         # exact, tested versions
python -m uvicorn backend.main:app --host 0.0.0.0 --port 8000
# open http://localhost:8000

requirements.lock pins exact versions so it builds the same everywhere; requirements.txt is the top-level list you edit.

Tests

python -m pytest tests/ -v    # backend
npx vitest run                # frontend unit
npx playwright test           # end-to-end (browser)

Transparency

Wymber is developed with heavy AI assistance (Claude Code), and every change is reviewed and audited by the maintainer before it ships. The project is open-source under AGPL-3.0 for exactly this reason: a privacy tool should be auditable. If a privacy claim here matters to you, you can read the code that backs it.

Crisis resources

If you're in crisis, please reach out:

  • 988 — Suicide & Crisis Lifeline (US)
  • Text HOME to 741741 — Crisis Text Line
  • 911 — Emergency services

License

AGPL-3.0. The copyleft keeps network-deployed forks open; the maintainer may offer an official hosted / sync product separately.

About

A private, local-first space to map and understand your experiences — privacy-first, trauma-informed, open-source.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors