pydantic-rag-agent 0.1.0__tar.gz

pydantic_rag_agent-0.1.0/LICENSE

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

pydantic_rag_agent-0.1.0/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: pydantic-rag-agent
+Version: 0.1.0
+Summary: A RAG agent built on Pydantic.
+Keywords: rag,retrieval-augmented-generation,pydantic,pydantic-ai,llm,vector-search
+Author: Nick
+Author-email: Nick <98120512+hanku4u@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Typing :: Typed
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: pydantic-ai-slim[openai]>=2.61,<3
+Requires-Dist: pydantic-settings>=2.16.1
+Requires-Dist: pypdfium2>=5.14.0
+Requires-Dist: python-docx>=1.2.0
+Requires-Dist: python-dotenv>=1.2.4
+Requires-Dist: python-pptx>=1.0.2
+Requires-Dist: rich>=15.0.0
+Requires-Dist: tiktoken>=0.14.0
+Requires-Dist: typer>=0.27.3
+Requires-Dist: pydantic-rag-agent[chroma,api,ui,s3] ; extra == 'all'
+Requires-Dist: fastapi>=0.162.0 ; extra == 'api'
+Requires-Dist: python-multipart>=0.0.32 ; extra == 'api'
+Requires-Dist: uvicorn[standard]>=0.54.0 ; extra == 'api'
+Requires-Dist: chromadb>=1.5.9 ; extra == 'chroma'
+Requires-Dist: boto3>=1.35 ; extra == 's3'
+Requires-Dist: streamlit>=1.66.1 ; extra == 'ui'
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/hanku4u/pydantic-rag-agent
+Project-URL: Repository, https://github.com/hanku4u/pydantic-rag-agent
+Project-URL: Documentation, https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/README.md
+Project-URL: Issues, https://github.com/hanku4u/pydantic-rag-agent/issues
+Provides-Extra: all
+Provides-Extra: api
+Provides-Extra: chroma
+Provides-Extra: s3
+Provides-Extra: ui
+Description-Content-Type: text/markdown
+
+# pydantic-rag-agent
+
+A retrieval-augmented generation (RAG) agent built on [Pydantic](https://docs.pydantic.dev/)
+and managed with [uv](https://docs.astral.sh/uv/).
+
+> **Status:** feature-complete for a local, single-user deployment. M0–M5 are done and
+> M6 is closed apart from OPS-1 (instrumentation), which is deliberately out of scope.
+> Ingestion, retrieval, the agent, the API, the CLI and the Streamlit UI all work; the
+> suite runs offline at 92% branch coverage. `main` is the state described in
+> [`docs/overview.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/overview.md#current-state); the ordered plan behind it is in
+> [`docs/features/`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/features/README.md) and
+> [`docs/roadmap.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/roadmap.md).
+
+## Why uv?
+
+Dependency resolution and virtualenv handling live in one fast tool, and `uv.lock`
+pins the exact graph so your CI and your laptop agree on what "it works" means.
+
+## Documentation
+
+Full documentation lives in [`docs/`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/README.md) — start with the
+[documentation index](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/README.md) or the [project overview](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/overview.md).
+Design rationale is recorded as [decision records](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/README.md).
+
+Coding agents should read [`AGENTS.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/AGENTS.md) first.
+
+## Requirements
+
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) 0.13 or newer
+- Python 3.11+ — uv will fetch and manage the interpreter for you if needed
+
+## Install
+
+```bash
+uv add "pydantic-rag-agent"               # core: agent, loaders, CLI, in-memory store
+uv add "pydantic-rag-agent[chroma]"       # plus the default persistent store
+uv add "pydantic-rag-agent[chroma,ui]"    # plus the Streamlit UI
+uv add "pydantic-rag-agent[chroma,api]"   # plus the FastAPI integration
+uv add "pydantic-rag-agent[chroma,s3]"    # plus originals in a bucket
+uv add "pydantic-rag-agent[all]"          # everything
+```
+
+The core install has no vector database: it runs with the in-memory store, which is fine
+for a script that ingests and asks in one go. Anything the agent does not need at import
+time is an extra, and a missing one tells you which to install.
+
+> **Not on PyPI yet.** The first release is milestone 7 — see
+> [`docs/features/`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/features/README.md) and
+> [ADR 0013](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/0013-packaging-and-release.md). Until then, install from the
+> repository as below.
+
+As a library, from the repository today (and from PyPI once published):
+
+```python
+from pydantic_rag_agent import RagAgent
+
+agent = RagAgent.from_env()
+agent.ingest_sync("./docs")
+print(agent.ask_sync("How long are backups retained?").text)
+```
+
+The async methods (`await agent.ask(...)`, `async for update in agent.stream(...)`) are
+what a web app wants; the sync helpers exist so a script does not have to become async to
+ask one question. Answers carry citations back to the source document, including the
+locator of the stored original (`file://` or `s3://`).
+
+Already have a FastAPI app? Mount the router instead of running a second service:
+
+```python
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI
+
+from pydantic_rag_agent import RagAgent
+from pydantic_rag_agent.integrations.fastapi import create_router
+
+agent = RagAgent.from_env()
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    await agent.check_index()
+    try:
+        yield
+    finally:
+        await agent.aclose()
+
+
+app = FastAPI(lifespan=lifespan)
+app.include_router(create_router(agent), prefix="/knowledge")
+```
+
+The router brings the routes; your app keeps its lifespan, its auth and its shutdown.
+
+Any OpenAI-speaking chat UI can be pointed at the agent instead of a bespoke frontend:
+
+```python
+from pydantic_rag_agent.integrations.fastapi import create_openai_router
+
+app.include_router(create_openai_router(agent, model_id="acme-knowledge"), prefix="/openai")
+```
+
+Point the client at `https://your-host/openai/v1`. Requests are stateless (the client
+sends the thread), caller-supplied system messages are ignored, and answers carry a
+`Sources:` footer. `serve` already exposes the same route at `/v1`, so a chat UI can be
+pointed at a running server without writing any code — `--openai-model-id` chooses the name
+the client shows. See [ADR 0014](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/0014-openai-compatible-endpoint.md).
+
+## Getting started from the repository
+
+```bash
+# Clone and enter the project
+git clone git@github.com:hanku4u/pydantic-rag-agent.git
+cd pydantic-rag-agent
+
+# Create .venv and install the project plus its dependencies
+uv sync
+
+# Provide the one credential: chat, captions, and embeddings all use it
+cp .env.example .env
+# then edit .env and set OPENROUTER_API_KEY
+
+# Index and ask — the agent runs in this process, no server needed
+uv run pydantic-rag-agent ingest ./docs
+uv run pydantic-rag-agent ask "How long are backups retained?"
+
+# Optional: the API and web UI together
+uv run pydantic-rag-agent dev
+```
+
+The terminal answer streams and ends with a table of the sources it cited. The chat UI
+from `dev` is at <http://127.0.0.1:8501>. `--api-url` makes any command talk to a running
+server instead of building the agent locally.
+
+## Day-to-day commands
+
+| Task | Command |
+| --- | --- |
+| Install or refresh dependencies | `uv sync` |
+| Add a runtime dependency | `uv add <package>` |
+| Add a dev-only dependency | `uv add --dev <package>` |
+| Remove a dependency | `uv remove <package>` |
+| Run a command inside the venv | `uv run <command>` |
+| Run a script without installing it | `uv run path/to/script.py` |
+
+## Project layout
+
+```text
+pydantic-rag-agent/
+├── pyproject.toml            # project metadata, dependencies, CLI entry point
+├── uv.lock                   # exact resolved versions — commit this
+├── .python-version           # interpreter uv should use
+├── AGENTS.md                 # orientation for coding agents
+├── docs/                     # design, backlog, decisions — start at docs/README.md
+├── src/
+│   └── pydantic_rag_agent/
+│       ├── __init__.py       # package marker, no import-time side effects
+│       └── cli.py            # command-line entry point (`main`)
+└── README.md
+```
+
+The `src/` layout keeps the package importable from an installed build rather
+than by accident from the working directory, which is what makes
+`uv run pytest` behave the same as a real install.
+
+## Configuration
+
+Settings are a tree of six nodes — provider, embeddings, vector store, storage,
+ingestion, agent — read from `PRAGENT_*` environment variables via `pydantic-settings`.
+Nesting is addressed with a double underscore: `PRAGENT_PROVIDER__MODEL`,
+`PRAGENT_AGENT__TOP_K`. Each node can also be constructed in code, which is how the
+library is used.
+
+Credentials keep their conventional names (`OPENROUTER_API_KEY`) and are never read from
+a committed file. Every variable, its default, and the mapping from the pre-0.1.0 flat
+names are in [`docs/reference/configuration.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/reference/configuration.md).
+
+The `.gitignore` ignores `.env` and any `.env.*` file except `.env.example`.
+
+## Contributing
+
+1. `uv sync` to get a working environment.
+2. Pick a feature ID from the [backlog](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/features/README.md) and reference it in
+   your commit subject.
+3. Add tests under `tests/` next to the module they cover.
+4. `uv run pytest` before opening a pull request.
+
+## License
+
+[MIT](https://github.com/hanku4u/pydantic-rag-agent/blob/main/LICENSE). Use it, fork it, ship it — just keep the copyright notice.
+
+The dependency stack is deliberately permissive end to end; the one AGPL package that
+previously blocked this was replaced. See
+[`docs/reference/dependencies.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/reference/dependencies.md) for the details, and
+[ADR 0007](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/0007-mit-licence-and-pypdfium2.md) for the reasoning.

pydantic_rag_agent-0.1.0/README.md

@@ -0,0 +1,195 @@
+# pydantic-rag-agent
+
+A retrieval-augmented generation (RAG) agent built on [Pydantic](https://docs.pydantic.dev/)
+and managed with [uv](https://docs.astral.sh/uv/).
+
+> **Status:** feature-complete for a local, single-user deployment. M0–M5 are done and
+> M6 is closed apart from OPS-1 (instrumentation), which is deliberately out of scope.
+> Ingestion, retrieval, the agent, the API, the CLI and the Streamlit UI all work; the
+> suite runs offline at 92% branch coverage. `main` is the state described in
+> [`docs/overview.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/overview.md#current-state); the ordered plan behind it is in
+> [`docs/features/`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/features/README.md) and
+> [`docs/roadmap.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/roadmap.md).
+
+## Why uv?
+
+Dependency resolution and virtualenv handling live in one fast tool, and `uv.lock`
+pins the exact graph so your CI and your laptop agree on what "it works" means.
+
+## Documentation
+
+Full documentation lives in [`docs/`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/README.md) — start with the
+[documentation index](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/README.md) or the [project overview](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/overview.md).
+Design rationale is recorded as [decision records](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/README.md).
+
+Coding agents should read [`AGENTS.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/AGENTS.md) first.
+
+## Requirements
+
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) 0.13 or newer
+- Python 3.11+ — uv will fetch and manage the interpreter for you if needed
+
+## Install
+
+```bash
+uv add "pydantic-rag-agent"               # core: agent, loaders, CLI, in-memory store
+uv add "pydantic-rag-agent[chroma]"       # plus the default persistent store
+uv add "pydantic-rag-agent[chroma,ui]"    # plus the Streamlit UI
+uv add "pydantic-rag-agent[chroma,api]"   # plus the FastAPI integration
+uv add "pydantic-rag-agent[chroma,s3]"    # plus originals in a bucket
+uv add "pydantic-rag-agent[all]"          # everything
+```
+
+The core install has no vector database: it runs with the in-memory store, which is fine
+for a script that ingests and asks in one go. Anything the agent does not need at import
+time is an extra, and a missing one tells you which to install.
+
+> **Not on PyPI yet.** The first release is milestone 7 — see
+> [`docs/features/`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/features/README.md) and
+> [ADR 0013](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/0013-packaging-and-release.md). Until then, install from the
+> repository as below.
+
+As a library, from the repository today (and from PyPI once published):
+
+```python
+from pydantic_rag_agent import RagAgent
+
+agent = RagAgent.from_env()
+agent.ingest_sync("./docs")
+print(agent.ask_sync("How long are backups retained?").text)
+```
+
+The async methods (`await agent.ask(...)`, `async for update in agent.stream(...)`) are
+what a web app wants; the sync helpers exist so a script does not have to become async to
+ask one question. Answers carry citations back to the source document, including the
+locator of the stored original (`file://` or `s3://`).
+
+Already have a FastAPI app? Mount the router instead of running a second service:
+
+```python
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI
+
+from pydantic_rag_agent import RagAgent
+from pydantic_rag_agent.integrations.fastapi import create_router
+
+agent = RagAgent.from_env()
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    await agent.check_index()
+    try:
+        yield
+    finally:
+        await agent.aclose()
+
+
+app = FastAPI(lifespan=lifespan)
+app.include_router(create_router(agent), prefix="/knowledge")
+```
+
+The router brings the routes; your app keeps its lifespan, its auth and its shutdown.
+
+Any OpenAI-speaking chat UI can be pointed at the agent instead of a bespoke frontend:
+
+```python
+from pydantic_rag_agent.integrations.fastapi import create_openai_router
+
+app.include_router(create_openai_router(agent, model_id="acme-knowledge"), prefix="/openai")
+```
+
+Point the client at `https://your-host/openai/v1`. Requests are stateless (the client
+sends the thread), caller-supplied system messages are ignored, and answers carry a
+`Sources:` footer. `serve` already exposes the same route at `/v1`, so a chat UI can be
+pointed at a running server without writing any code — `--openai-model-id` chooses the name
+the client shows. See [ADR 0014](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/0014-openai-compatible-endpoint.md).
+
+## Getting started from the repository
+
+```bash
+# Clone and enter the project
+git clone git@github.com:hanku4u/pydantic-rag-agent.git
+cd pydantic-rag-agent
+
+# Create .venv and install the project plus its dependencies
+uv sync
+
+# Provide the one credential: chat, captions, and embeddings all use it
+cp .env.example .env
+# then edit .env and set OPENROUTER_API_KEY
+
+# Index and ask — the agent runs in this process, no server needed
+uv run pydantic-rag-agent ingest ./docs
+uv run pydantic-rag-agent ask "How long are backups retained?"
+
+# Optional: the API and web UI together
+uv run pydantic-rag-agent dev
+```
+
+The terminal answer streams and ends with a table of the sources it cited. The chat UI
+from `dev` is at <http://127.0.0.1:8501>. `--api-url` makes any command talk to a running
+server instead of building the agent locally.
+
+## Day-to-day commands
+
+| Task | Command |
+| --- | --- |
+| Install or refresh dependencies | `uv sync` |
+| Add a runtime dependency | `uv add <package>` |
+| Add a dev-only dependency | `uv add --dev <package>` |
+| Remove a dependency | `uv remove <package>` |
+| Run a command inside the venv | `uv run <command>` |
+| Run a script without installing it | `uv run path/to/script.py` |
+
+## Project layout
+
+```text
+pydantic-rag-agent/
+├── pyproject.toml            # project metadata, dependencies, CLI entry point
+├── uv.lock                   # exact resolved versions — commit this
+├── .python-version           # interpreter uv should use
+├── AGENTS.md                 # orientation for coding agents
+├── docs/                     # design, backlog, decisions — start at docs/README.md
+├── src/
+│   └── pydantic_rag_agent/
+│       ├── __init__.py       # package marker, no import-time side effects
+│       └── cli.py            # command-line entry point (`main`)
+└── README.md
+```
+
+The `src/` layout keeps the package importable from an installed build rather
+than by accident from the working directory, which is what makes
+`uv run pytest` behave the same as a real install.
+
+## Configuration
+
+Settings are a tree of six nodes — provider, embeddings, vector store, storage,
+ingestion, agent — read from `PRAGENT_*` environment variables via `pydantic-settings`.
+Nesting is addressed with a double underscore: `PRAGENT_PROVIDER__MODEL`,
+`PRAGENT_AGENT__TOP_K`. Each node can also be constructed in code, which is how the
+library is used.
+
+Credentials keep their conventional names (`OPENROUTER_API_KEY`) and are never read from
+a committed file. Every variable, its default, and the mapping from the pre-0.1.0 flat
+names are in [`docs/reference/configuration.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/reference/configuration.md).
+
+The `.gitignore` ignores `.env` and any `.env.*` file except `.env.example`.
+
+## Contributing
+
+1. `uv sync` to get a working environment.
+2. Pick a feature ID from the [backlog](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/features/README.md) and reference it in
+   your commit subject.
+3. Add tests under `tests/` next to the module they cover.
+4. `uv run pytest` before opening a pull request.
+
+## License
+
+[MIT](https://github.com/hanku4u/pydantic-rag-agent/blob/main/LICENSE). Use it, fork it, ship it — just keep the copyright notice.
+
+The dependency stack is deliberately permissive end to end; the one AGPL package that
+previously blocked this was replaced. See
+[`docs/reference/dependencies.md`](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/reference/dependencies.md) for the details, and
+[ADR 0007](https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/decisions/0007-mit-licence-and-pypdfium2.md) for the reasoning.

pydantic_rag_agent-0.1.0/pyproject.toml

@@ -0,0 +1,138 @@
+[project]
+name = "pydantic-rag-agent"
+version = "0.1.0"
+description = "A RAG agent built on Pydantic."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "rag",
+    "retrieval-augmented-generation",
+    "pydantic",
+    "pydantic-ai",
+    "llm",
+    "vector-search",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Framework :: FastAPI",
+    "Framework :: Pydantic",
+    "Framework :: Pydantic :: 2",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: Indexing",
+]
+requires-python = ">=3.11"
+dependencies = [
+    "httpx>=0.28.1",
+    "pillow>=13.0.0",
+    "pydantic>=2.14.1",
+    "pydantic-ai-slim[openai]>=2.61,<3",
+    "pydantic-settings>=2.16.1",
+    "pypdfium2>=5.14.0",
+    "python-docx>=1.2.0",
+    "python-dotenv>=1.2.4",
+    "python-pptx>=1.0.2",
+    "rich>=15.0.0",
+    "tiktoken>=0.14.0",
+    "typer>=0.27.3",
+]
+
+[[project.authors]]
+name = "Nick"
+email = "98120512+hanku4u@users.noreply.github.com"
+
+[project.optional-dependencies]
+chroma = ["chromadb>=1.5.9"]
+api = [
+    "fastapi>=0.162.0",
+    "python-multipart>=0.0.32",
+    "uvicorn[standard]>=0.54.0",
+]
+ui = ["streamlit>=1.66.1"]
+s3 = ["boto3>=1.35"]
+all = ["pydantic-rag-agent[chroma,api,ui,s3]"]
+
+[project.scripts]
+pydantic-rag-agent = "pydantic_rag_agent.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/hanku4u/pydantic-rag-agent"
+Repository = "https://github.com/hanku4u/pydantic-rag-agent"
+Documentation = "https://github.com/hanku4u/pydantic-rag-agent/blob/main/docs/README.md"
+Issues = "https://github.com/hanku4u/pydantic-rag-agent/issues"
+
+[build-system]
+requires = ["uv_build>=0.13.1,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.4.0",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "pytest-cov>=7.1.0",
+    "ruff>=0.17.2",
+    "boto3>=1.35",
+    "chromadb>=1.5.9",
+    "fastapi>=0.162.0",
+    "python-multipart>=0.0.32",
+    "streamlit>=1.66.1",
+    "uvicorn[standard]>=0.54.0",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+pythonpath = ["tests"]
+python_functions = [
+    "test_*",
+    "*_should_*",
+]
+
+[tool.coverage.run]
+source = ["pydantic_rag_agent"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 85
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+]
+omit = ["*/ui/*"]
+
+[tool.mypy]
+python_version = "3.11"
+disallow_untyped_defs = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+plugins = ["pydantic.mypy"]
+
+[[tool.mypy.overrides]]
+module = [
+    "pypdfium2",
+    "pypdfium2.*",
+]
+ignore_missing_imports = true