amir: My AI Portfolio

Production systems I shipped — rebuilt lean, still the real stack.

AI portfolio monorepo: shared libs, Streamlit apps, ingest jobs, and a docs super-app. An open-source-first RAG stack over my research papers, with uv workspaces and an enforceable import DAG — the same shapes I shipped in production, smaller so you can see the wiring.

✨ What’s inside

flowchart LR
  PDFs["assets/pdf/papers"] --> Ingest["papers-ingest"]
  Ingest --> Chroma["Chroma local"]
  Chroma --> App["papers-rag Streamlit"]
  App --> OpenAI["OpenAI GPT"]
  Embed["bge-small local"] --> Ingest
  Embed --> App
  Core["libs/rag-core"] --> Ingest
  Core --> App

Topology is strict: apps/ and projects/ may depend on libs/ only. Full DAG and ADRs live in the architecture portal.

🚀 Quick start

uv tool install poethepoet
poe sync                      # install workspace from uv.lock
cp .env.example .env          # set OPENAI_API_KEY
poe ingest-papers             # first run downloads the embedding model
poe run-papers-rag            # open the Streamlit chat
poe docs                      # build the docs super-app into site/

Then open site/index.html — or the published hub at amirhessam88.github.io/amir.

📦 PyPI

pip install amir

One wheel. It bundles rag.core, papers_rag, and papers_ingest (APIs plus the papers-ingest / papers-rag CLIs). Not a git checkout: no docs portal, no poe toolchain, no paper PDFs. Leaf dirs stay workspace packages locally; they are not published on their own.

export OPENAI_API_KEY=...
export PAPERS_DIR=/path/to/pdfs
export CHROMA_DIR=/path/to/chroma
papers-ingest
papers-rag

Clone this repo when you want the full org (docs, PDFs, Docker, developer loop).

🆓 Free / OSS stack

🧪 Quality

poe test gates 100% branch coverage on amir, rag.core, papers_rag, and papers_ingest. CI runs that suite on Ubuntu and macOS across Python 3.11–3.13, then uploads xmlcov/coverage.xml to Codecov.

poe verify    # check (ruff + mypy) + test

Same gate CI runs. Dep upgrades: poe upgrade (or poe upgrade ruff). See CONTRIBUTING.md.

📚 Docs