extremis 0.1.0__tar.gz

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

@@ -0,0 +1,72 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_call:   # allows publish.yml to reuse this job
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/
+
+  typecheck:
+    name: Type check (mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install with dev deps
+        run: pip install -e ".[dev]"
+      - run: mypy src/extremis --ignore-missing-imports
+
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install with dev deps
+        run: pip install -e ".[dev]"
+      - name: Run tests with coverage
+        run: |
+          pytest tests/ -v --tb=short \
+            --cov=extremis \
+            --cov-report=term-missing \
+            --cov-fail-under=65
+      - name: Upload coverage
+        if: matrix.python-version == '3.11'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: .coverage
+
+  build:
+    name: Build check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*

extremis-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish to PyPI
+
+# Triggers on a git tag like v0.1.0
+# CI must pass first — the `needs: ci` gate enforces this.
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml   # reuse the full CI job
+
+  publish:
+    name: Build and publish
+    needs: ci                          # only runs if CI is green
+    runs-on: ubuntu-latest
+    environment: pypi                  # requires a "pypi" environment in repo settings
+    permissions:
+      id-token: write                  # required for PyPI trusted publisher (no API key needed)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Verify the build
+        run: |
+          pip install twine
+          twine check dist/*
+          echo "--- dist contents ---"
+          ls -lh dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # No API token needed — uses OIDC trusted publisher

extremis-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.env
+*.db
+*.jsonl
+~/.friday/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/

extremis-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

extremis-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,71 @@
+# Contributing
+
+Thanks for taking the time to contribute.
+
+## Getting started
+
+```bash
+git clone https://github.com/ashwanijha04/extremis
+cd extremis
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+Run the tests:
+```bash
+pytest tests/ -v
+```
+
+Run lint and type checks:
+```bash
+ruff check src/ tests/
+mypy src/extremis --ignore-missing-imports
+```
+
+## What we're looking for
+
+**Good contributions:**
+- Bug fixes with a test that would have caught the bug
+- New storage backends (e.g. Redis, DynamoDB) that implement `MemoryStore`
+- New embedder implementations (e.g. OpenAI, Cohere) that implement `Embedder`
+- Performance improvements to the SQLite cosine search
+- Documentation improvements
+
+**Please discuss first (open an issue):**
+- New memory layers or significant changes to `types.py`
+- Changes to the consolidation prompt strategy
+- Anything that changes the public API surface
+
+## How to add a new storage backend
+
+Implement the `MemoryStore` protocol from `extremis.interfaces`:
+
+```python
+from extremis.interfaces import MemoryStore
+from extremis.types import Memory, MemoryLayer, RecallResult
+
+class MyStore:
+    def store(self, memory: Memory) -> Memory: ...
+    def get(self, memory_id: UUID) -> Optional[Memory]: ...
+    def search(self, query_embedding, layers=None, limit=10, min_score=0.0) -> list[RecallResult]: ...
+    def update_score(self, memory_id: UUID, delta: float) -> None: ...
+    def supersede(self, old_id: UUID, new_memory: Memory) -> None: ...
+    def list_recent(self, layer=None, limit=50) -> list[Memory]: ...
+```
+
+Add tests in `tests/test_<backend>.py`. Use the existing `test_core.py` as a reference.
+
+## Pull request checklist
+
+- [ ] Tests pass (`pytest tests/ -v`)
+- [ ] Lint passes (`ruff check src/ tests/`)
+- [ ] New behaviour has test coverage
+- [ ] No secrets or personal data in code or tests
+
+## Reporting bugs
+
+Open an issue with:
+1. Python version
+2. OS
+3. Minimal reproduction script
+4. Expected vs actual behaviour

extremis-0.1.0/Dockerfile

@@ -0,0 +1,25 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# system deps for psycopg2
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq-dev gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml README.md LICENSE ./
+COPY src/ src/
+
+RUN pip install --no-cache-dir ".[server,postgres,openai]"
+
+# pre-download the default embedding model so first request isn't slow
+RUN python -c "from sentence_transformers import SentenceTransformer; SentenceTransformer('all-MiniLM-L6-v2')" || true
+
+ENV EXTREMIS_SERVER_HOME=/data/server
+ENV EXTREMIS_STORE=sqlite
+ENV EXTREMIS_HOME=/data
+
+VOLUME ["/data"]
+EXPOSE 8000
+
+CMD ["extremis-server", "serve", "--host", "0.0.0.0", "--port", "8000"]

extremis-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ashwani Jha
+
+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.