Metadata-Version: 2.3
Name: amie
Version: 0.1.7
Summary: Your private memory intelligence — captures thoughts from anywhere, organises them into your vault, and reflects insights back to you. Entirely local.
Keywords: obsidian,notes,ocr,ollama,local-ai,knowledge-management
Author: nk0s1
Author-email: nk0s1 <nkosinathi@whakatau.com>
License: MIT License
         
         Copyright (c) 2026 nk0s1
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
         in the Software without restriction, including without limitation the rights
         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
         copies of the Software, and to permit persons to whom the Software is
         furnished to do so, subject to the following conditions:
         
         The above copyright notice and this permission notice shall be included in all
         copies or substantial portions of the Software.
         
         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Office/Business :: News/Diary
Classifier: Topic :: Text Processing :: Markup
Classifier: Topic :: Utilities
Requires-Dist: ollama>=0.6.2
Requires-Dist: pillow-heif>=1.3.0
Requires-Dist: python-dotenv>=1.2.2
Requires-Dist: python-frontmatter>=1.1.0
Requires-Dist: typer>=0.25.1
Requires-Dist: urllib3>=2.7.0
Requires-Dist: watchdog>=6.0.0
Requires-Python: >=3.12
Project-URL: Documentation, https://gitlab.com/nkosinathi1/amie/-/tree/main/docs
Project-URL: Issues, https://gitlab.com/nkosinathi1/amie/-/issues
Project-URL: Source, https://gitlab.com/nkosinathi1/amie
Description-Content-Type: text/markdown

# AMI — Anonymous Memory Intelligence

Your private memory intelligence — captures thoughts from anywhere, organises them into your vault, and reflects insights back to you. Entirely local.

**Status:** Alpha. The core CLI and domain modules are in place; ingestion, OCR, and the weekly-digest pipeline are still being built.

**Hard constraints:**
- Open-source, no paid services.
- Local-first AI via Ollama only — your notes never leave your device.
- Built for the user's existing Obsidian vault conventions (`KEY: value` headers, lifecycle states `#infant → #child → #developing → #adult → #on-ice → #removed`).

## Install

```bash
# Prereqs: Python 3.12, uv, and Ollama. See docs/01-prerequisites.md.
git clone git@gitlab.com:nkosinathi1/ami.git ~/source/repos/ami
cd ~/source/repos/ami
uv sync
ami init        # one-time setup wizard
ami doctor      # verify uv / Ollama / models / vault / ssh
```

## Try it

```bash
ami --help                # discover every subcommand
ami doctor                # health-check the environment
ami vault status          # confirm inbox folders are in place
ami dev guard             # lint + format check + tests + security audit
```

## Documentation

The build guide and operator manual live at `~/source/ubuntu/docs/ami/`:

- `00-overview.md` — start here.
- `standards.md` — engineering rules every contribution is held to.
- `security.md` — threat model.
- `14-cli-reference.md` — every `ami` command, what it does.
- `15-ide-setup.md` — VS Code + WSL setup.
- `activity-log.md` — append-only audit trail of every change.

## License

MIT. See `LICENSE`.
