memex-ai 0.1.0__tar.gz

memex_ai-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,37 @@
+name: Bug report
+description: Report a reproducible memex bug
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Minimal code or commands that reproduce the issue.
+      render: python
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: memex version
+    validations:
+      required: true
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      options:
+        - Linux
+        - macOS
+        - Windows
+        - Other
+    validations:
+      required: true

memex_ai-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,24 @@
+name: Feature request
+description: Suggest an improvement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What user problem should memex solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: What would you like to change?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives
+      description: What alternatives did you consider?

memex_ai-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## Summary
+
+## Tests
+
+## Benchmark impact
+
+## Notes for reviewers

memex_ai-0.1.0/.github/workflows/benchmarks.yml

@@ -0,0 +1,21 @@
+name: Benchmarks
+
+on:
+  pull_request:
+    paths:
+      - "memex/**"
+      - "benchmarks/**"
+      - "tests/benchmarks/**"
+  workflow_dispatch:
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[benchmark]"
+      - run: python benchmarks/bench_memex.py --count 1000 --queries 25

memex_ai-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[test]" ruff mypy
+      - run: ruff check .
+      - run: mypy memex
+      - run: pytest --cov=memex
+
+  javascript:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - working-directory: js
+        run: npm install
+      - working-directory: js
+        run: npm run typecheck
+      - working-directory: js
+        run: npm run build

memex_ai-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,41 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade pip build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  npm:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+      - working-directory: js
+        run: npm install
+      - working-directory: js
+        run: npm run build
+      - working-directory: js
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

memex_ai-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+*.egg-info/
+
+node_modules/
+js/node_modules/
+js/dist/
+js/coverage/
+
+.DS_Store
+Thumbs.db
+*.db
+*.db-shm
+*.db-wal

memex_ai-0.1.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog, and this project uses semantic versioning after 0.1.0.
+
+## [0.1.0] - Unreleased
+
+### Added
+
+- Local-first Python `Memory` API.
+- SQLite storage with optional sqlite-vec acceleration and Python fallback.
+- Deterministic hash embedder plus optional sentence-transformers and OpenAI embedders.
+- CLI, REST server, import/export, pruning, deduplication, and local fact extraction.
+- TypeScript package with local and REST-backed memory clients.

memex_ai-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing
+
+Thanks for helping build memex.
+
+## Development setup
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+ruff check .
+mypy memex
+```
+
+On Windows PowerShell:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\Activate.ps1
+pip install -e ".[dev]"
+pytest
+```
+
+## Design principles
+
+- Keep the core local-first.
+- Avoid network calls unless users explicitly opt in.
+- Prefer SQLite and small local adapters over external infrastructure.
+- Keep the public API small.
+- Make heavy dependencies optional or lazy.
+- Tests must not download models or require API keys.
+
+## Pull requests
+
+Please include:
+
+- A clear problem statement.
+- Tests for changed behavior.
+- Documentation updates for public API changes.
+- Benchmark notes for storage, embedding, or search changes.
+
+## Release checklist
+
+1. Update `CHANGELOG.md`.
+2. Run `pytest`, `ruff`, `mypy`, and JS `npm test` when JS changed.
+3. Build Python and npm packages.
+4. Tag `vX.Y.Z`.
+5. Publish from CI with trusted publishing.

memex_ai-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 memex contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.