perfectrag 0.1.0__tar.gz

perfectrag-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+dist/
+build/
+.coverage
+htmlcov/
+.idea/
+.vscode/
+*.swp
+.DS_Store

perfectrag-0.1.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: perfectrag
+Version: 0.1.0
+Summary: Dynamic RAG framework scaffolder — wizard-driven, hardware-aware, docker-ready
+Project-URL: Homepage, https://github.com/your-org/perfectrag
+Project-URL: Issues, https://github.com/your-org/perfectrag/issues
+Author: perfectRAG
+License: Apache-2.0
+Keywords: docker,graphrag,mcp,ollama,rag,scaffolder,wizard
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: copier>=9.3
+Requires-Dist: distro>=1.9
+Requires-Dist: inquirerpy>=0.3.4
+Requires-Dist: jinja2>=3.1
+Requires-Dist: nvidia-ml-py>=12.535
+Requires-Dist: psutil>=5.9
+Requires-Dist: py-cpuinfo>=9.0
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# perfectRAG
+
+
+> Dynamic RAG framework scaffolder — wizard hỏi vài câu, detect hardware, rồi sinh ra service RAG hoàn chỉnh (docker-compose + UI + API) chạy ngay.
+
+Thay vì copy–paste docker-compose từ RAGFlow/Dify/LightRAG rồi loay hoay sửa `.env`, `perfectrag init` sẽ:
+
+1. Detect hardware (CPU/GPU/RAM/VRAM).
+2. Hỏi bạn 6 câu về use-case (Q&A / GraphRAG / agentic / multimodal / code RAG).
+3. Tự chọn tech stack phù hợp: LLM, embedding, reranker, vector DB, parser.
+4. Scaffold project hoàn chỉnh: `docker-compose.yml` + `.env` + `mcp.yaml` + `skills/` + README.
+5. `docker compose up -d` → có ngay UI + API chạy trên localhost.
+
+Tất cả **free & open-source**, không vendor lock-in.
+
+## Install
+
+```bash
+pip install perfectrag
+# hoặc từ source: pip install -e ".[dev]"
+```
+
+## Quickstart
+
+```bash
+perfectrag init my-rag
+cd my-rag
+docker compose up -d
+```
+
+Mở UI theo stack đã chọn:
+- `custom-naive-rag` → http://localhost:3000 (open-webui)
+- `ragflow-stack` → http://localhost (RAGFlow)
+- `lightrag-stack` → http://localhost:9621 (LightRAG WebUI)
+- `dify-stack` → http://localhost (Dify)
+
+## Commands
+
+| Command | Mô tả |
+|---|---|
+| `perfectrag init [DIR]` | Wizard → scaffold project |
+| `perfectrag init DIR --template ragflow-stack` | Force template, skip recommendation |
+| `perfectrag init DIR --answers-file a.yml` | Non-interactive (CI) |
+| `perfectrag init DIR --dry-run` | Preview recipe, không ghi file |
+| `perfectrag hw` | Detect hardware + show tier |
+| `perfectrag list templates` | Liệt kê templates bundled |
+| `perfectrag list mcp` | Liệt kê MCP servers trong registry |
+| `perfectrag list skills` | Liệt kê skills bundled |
+| `perfectrag add mcp <name> --project DIR` | Thêm MCP server vào project |
+| `perfectrag add skill <name> --project DIR` | Thêm skill vào project |
+
+## Templates
+
+| Template | Use-case | Key components | UI |
+|---|---|---|---|
+| `custom-naive-rag` | Q&A nhỏ, CPU-only, học | FastAPI + Qdrant + Ollama | open-webui |
+| `ragflow-stack` | Q&A hybrid search, agentic, MCP-native | RAGFlow + Elasticsearch + MySQL + Redis + MinIO + Ollama | RAGFlow |
+| `lightrag-stack` | GraphRAG / multi-hop reasoning | LightRAG + Ollama + open-webui | LightRAG WebUI |
+| `dify-stack` | Workflow / agent / no-code team | Dify + Postgres + Qdrant + Redis + Ollama | Dify Console |
+
+Chọn template khác? `perfectrag init DIR --template <name>`.
+
+## Hardware → tier mapping
+
+| Tier | Khi nào | Default stack |
+|---|---|---|
+| `cpu` | Không có GPU | `custom-naive-rag` + Qwen2.5 3B (q4) + nomic-embed |
+| `apple-low` | Apple Silicon ≤16 GB RAM | `ragflow-stack` + Qwen2.5 7B (q4) |
+| `apple-high` | Apple Silicon ≥24 GB RAM | `ragflow-stack` + Qwen2.5 14B (q4) |
+| `gpu-8gb` | NVIDIA 6–11 GB VRAM | `ragflow-stack` + Qwen2.5 7B (q5) + BGE-M3 |
+| `gpu-12gb` | NVIDIA 12–23 GB VRAM | `ragflow-stack` + Qwen2.5 14B (q4) |
+| `gpu-24gb` | NVIDIA ≥24 GB VRAM | `lightrag-stack`/`ragflow-stack` + Qwen2.5 32B (q4) + vLLM |
+
+Routing override hard rules:
+- `use_case=graphrag` **or** `multi_hop=true` → `lightrag-stack`
+- `use_case=agent_workflow` → `dify-stack`
+- `use_case=multimodal` → `ragflow-stack` (với Docling parser)
+
+## Extensibility
+
+### Add MCP tool
+
+Drop vào `mcp.yaml` của project, hoặc dùng CLI:
+
+```bash
+perfectrag add mcp tavily --project .
+# set TAVILY_API_KEY trong .env
+docker compose restart
+```
+
+Xem `perfectrag list mcp` cho 10 MCP servers có sẵn (filesystem, fetch, tavily, brave-search, postgres, sqlite, github, memory, sequential-thinking, qdrant).
+
+Thêm MCP tùy ý: edit `mcp.yaml` trực tiếp — format tương thích Claude Code / Cursor / Claude Desktop.
+
+### Add skill
+
+```bash
+perfectrag add skill legal-rag --project .
+```
+
+Bundled skills: `legal-rag`, `code-rag`, `medical-rag`, `research-rag`. Skill = `skills/<name>/SKILL.md` với YAML frontmatter — copy từ Claude Code skill format.
+
+Tự viết skill? Tạo file `skills/<name>/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: short one-liner
+---
+# my skill
+Retrieval / prompt instructions here...
+```
+
+### Contribute template
+
+Template = một thư mục Copier trong `src/perfectrag/templates/<name>/`:
+
+```
+<name>/
+├── copier.yml                    # _templates_suffix: .jinja
+├── docker-compose.yml.jinja     # dùng {{ recipe.* }}, {{ hw.* }}, {{ answers.* }}
+├── .env.jinja
+├── README.md.jinja
+├── mcp.yaml.jinja
+└── skills/.gitkeep
+```
+
+Thêm vào `_DESCRIPTIONS` trong `src/perfectrag/scaffolder.py` — xong.
+
+## Architecture
+
+```
+perfectrag CLI
+     │
+     ├─ hardware.py   (psutil + nvml + sysctl)
+     ├─ wizard.py     (InquirerPy conditional questions)
+     ├─ recipes.py    (decision matrix: answers+hw → recipe)
+     ├─ scaffolder.py (copier wrapper)
+     └─ templates/
+         ├─ custom-naive-rag/
+         ├─ ragflow-stack/
+         ├─ lightrag-stack/
+         ├─ dify-stack/
+         └─ _shared/skills/
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest              # 49 tests
+ruff check src tests
+mypy src
+```
+
+## License
+
+Apache-2.0

perfectrag-0.1.0/README.md

@@ -0,0 +1,158 @@
+# perfectRAG
+
+
+> Dynamic RAG framework scaffolder — wizard hỏi vài câu, detect hardware, rồi sinh ra service RAG hoàn chỉnh (docker-compose + UI + API) chạy ngay.
+
+Thay vì copy–paste docker-compose từ RAGFlow/Dify/LightRAG rồi loay hoay sửa `.env`, `perfectrag init` sẽ:
+
+1. Detect hardware (CPU/GPU/RAM/VRAM).
+2. Hỏi bạn 6 câu về use-case (Q&A / GraphRAG / agentic / multimodal / code RAG).
+3. Tự chọn tech stack phù hợp: LLM, embedding, reranker, vector DB, parser.
+4. Scaffold project hoàn chỉnh: `docker-compose.yml` + `.env` + `mcp.yaml` + `skills/` + README.
+5. `docker compose up -d` → có ngay UI + API chạy trên localhost.
+
+Tất cả **free & open-source**, không vendor lock-in.
+
+## Install
+
+```bash
+pip install perfectrag
+# hoặc từ source: pip install -e ".[dev]"
+```
+
+## Quickstart
+
+```bash
+perfectrag init my-rag
+cd my-rag
+docker compose up -d
+```
+
+Mở UI theo stack đã chọn:
+- `custom-naive-rag` → http://localhost:3000 (open-webui)
+- `ragflow-stack` → http://localhost (RAGFlow)
+- `lightrag-stack` → http://localhost:9621 (LightRAG WebUI)
+- `dify-stack` → http://localhost (Dify)
+
+## Commands
+
+| Command | Mô tả |
+|---|---|
+| `perfectrag init [DIR]` | Wizard → scaffold project |
+| `perfectrag init DIR --template ragflow-stack` | Force template, skip recommendation |
+| `perfectrag init DIR --answers-file a.yml` | Non-interactive (CI) |
+| `perfectrag init DIR --dry-run` | Preview recipe, không ghi file |
+| `perfectrag hw` | Detect hardware + show tier |
+| `perfectrag list templates` | Liệt kê templates bundled |
+| `perfectrag list mcp` | Liệt kê MCP servers trong registry |
+| `perfectrag list skills` | Liệt kê skills bundled |
+| `perfectrag add mcp <name> --project DIR` | Thêm MCP server vào project |
+| `perfectrag add skill <name> --project DIR` | Thêm skill vào project |
+
+## Templates
+
+| Template | Use-case | Key components | UI |
+|---|---|---|---|
+| `custom-naive-rag` | Q&A nhỏ, CPU-only, học | FastAPI + Qdrant + Ollama | open-webui |
+| `ragflow-stack` | Q&A hybrid search, agentic, MCP-native | RAGFlow + Elasticsearch + MySQL + Redis + MinIO + Ollama | RAGFlow |
+| `lightrag-stack` | GraphRAG / multi-hop reasoning | LightRAG + Ollama + open-webui | LightRAG WebUI |
+| `dify-stack` | Workflow / agent / no-code team | Dify + Postgres + Qdrant + Redis + Ollama | Dify Console |
+
+Chọn template khác? `perfectrag init DIR --template <name>`.
+
+## Hardware → tier mapping
+
+| Tier | Khi nào | Default stack |
+|---|---|---|
+| `cpu` | Không có GPU | `custom-naive-rag` + Qwen2.5 3B (q4) + nomic-embed |
+| `apple-low` | Apple Silicon ≤16 GB RAM | `ragflow-stack` + Qwen2.5 7B (q4) |
+| `apple-high` | Apple Silicon ≥24 GB RAM | `ragflow-stack` + Qwen2.5 14B (q4) |
+| `gpu-8gb` | NVIDIA 6–11 GB VRAM | `ragflow-stack` + Qwen2.5 7B (q5) + BGE-M3 |
+| `gpu-12gb` | NVIDIA 12–23 GB VRAM | `ragflow-stack` + Qwen2.5 14B (q4) |
+| `gpu-24gb` | NVIDIA ≥24 GB VRAM | `lightrag-stack`/`ragflow-stack` + Qwen2.5 32B (q4) + vLLM |
+
+Routing override hard rules:
+- `use_case=graphrag` **or** `multi_hop=true` → `lightrag-stack`
+- `use_case=agent_workflow` → `dify-stack`
+- `use_case=multimodal` → `ragflow-stack` (với Docling parser)
+
+## Extensibility
+
+### Add MCP tool
+
+Drop vào `mcp.yaml` của project, hoặc dùng CLI:
+
+```bash
+perfectrag add mcp tavily --project .
+# set TAVILY_API_KEY trong .env
+docker compose restart
+```
+
+Xem `perfectrag list mcp` cho 10 MCP servers có sẵn (filesystem, fetch, tavily, brave-search, postgres, sqlite, github, memory, sequential-thinking, qdrant).
+
+Thêm MCP tùy ý: edit `mcp.yaml` trực tiếp — format tương thích Claude Code / Cursor / Claude Desktop.
+
+### Add skill
+
+```bash
+perfectrag add skill legal-rag --project .
+```
+
+Bundled skills: `legal-rag`, `code-rag`, `medical-rag`, `research-rag`. Skill = `skills/<name>/SKILL.md` với YAML frontmatter — copy từ Claude Code skill format.
+
+Tự viết skill? Tạo file `skills/<name>/SKILL.md`:
+
+```markdown
+---
+name: my-skill
+description: short one-liner
+---
+# my skill
+Retrieval / prompt instructions here...
+```
+
+### Contribute template
+
+Template = một thư mục Copier trong `src/perfectrag/templates/<name>/`:
+
+```
+<name>/
+├── copier.yml                    # _templates_suffix: .jinja
+├── docker-compose.yml.jinja     # dùng {{ recipe.* }}, {{ hw.* }}, {{ answers.* }}
+├── .env.jinja
+├── README.md.jinja
+├── mcp.yaml.jinja
+└── skills/.gitkeep
+```
+
+Thêm vào `_DESCRIPTIONS` trong `src/perfectrag/scaffolder.py` — xong.
+
+## Architecture
+
+```
+perfectrag CLI
+     │
+     ├─ hardware.py   (psutil + nvml + sysctl)
+     ├─ wizard.py     (InquirerPy conditional questions)
+     ├─ recipes.py    (decision matrix: answers+hw → recipe)
+     ├─ scaffolder.py (copier wrapper)
+     └─ templates/
+         ├─ custom-naive-rag/
+         ├─ ragflow-stack/
+         ├─ lightrag-stack/
+         ├─ dify-stack/
+         └─ _shared/skills/
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest              # 49 tests
+ruff check src tests
+mypy src
+```
+
+## License
+
+Apache-2.0

perfectrag-0.1.0/docs/mcp.md

@@ -0,0 +1,66 @@
+# MCP (Model Context Protocol)
+
+perfectRAG uses MCP as the standard way to attach external tools to your RAG service. Each generated project ships with an `mcp.yaml` listing MCP servers the backbone will load.
+
+## Format
+
+```yaml
+servers:
+  <name>:
+    command: <binary or interpreter>
+    args: [...]
+    env: { VAR: "${VAR}" }   # optional
+```
+
+Tương thích với Claude Code / Cursor / Claude Desktop MCP config → portable.
+
+## Built-in registry (10 servers)
+
+`perfectrag list mcp` để xem danh sách cập nhật.
+
+| Name | Description | Env vars required |
+|---|---|---|
+| `filesystem` | Read/write files in whitelisted dir | — |
+| `fetch` | Fetch URL → markdown | — |
+| `tavily` | Tavily web search | `TAVILY_API_KEY` |
+| `brave-search` | Brave web search | `BRAVE_API_KEY` |
+| `postgres` | Read-only Postgres query | `POSTGRES_URL` |
+| `sqlite` | SQLite query | — |
+| `github` | GitHub repos/issues/PRs | `GITHUB_PERSONAL_ACCESS_TOKEN` |
+| `memory` | KG memory for agent | — |
+| `sequential-thinking` | Structured CoT | — |
+| `qdrant` | Qdrant vector MCP | — |
+
+## Add MCP to project
+
+```bash
+perfectrag add mcp tavily --project .
+```
+
+Thêm entry vào `mcp.yaml`, prompt env vars nếu cần. Sau đó:
+
+```bash
+# Nếu template có variable substitution cho env:
+echo "TAVILY_API_KEY=your-key" >> .env.local
+
+docker compose restart
+```
+
+## Custom MCP server
+
+Viết MCP server bằng bất kỳ ngôn ngữ nào (Python via [FastMCP](https://github.com/jlowin/fastmcp), Node via `@modelcontextprotocol/sdk`, Rust, Go...). Add vào `mcp.yaml`:
+
+```yaml
+servers:
+  my-tool:
+    command: python
+    args: ["./mcp_servers/my_tool.py"]
+```
+
+MCP server expose `tools` (callable), `resources` (data), và `prompts` (templates). Backbone (RAGFlow / Dify) tự detect và surface trong UI.
+
+## Khi nào MCP có / không load được
+
+- **RAGFlow** (≥v0.13) hỗ trợ MCP natively qua built-in gateway.
+- **Dify** có plugin marketplace riêng — `mcp.yaml` là phần supplementary.
+- **LightRAG** / **custom-naive-rag** hiện chưa auto-load — MCP ở đây là config-only, cần viết wire-up trong app code (ví dụ load MCP servers khi start FastAPI).

perfectrag-0.1.0/docs/skills.md

@@ -0,0 +1,50 @@
+# Skills
+
+Skills = domain-specific instructions (prompts, retrieval params) cho RAG service. Format mirror Claude Code's skill format.
+
+## Structure
+
+```
+skills/
+  <skill-name>/
+    SKILL.md      # YAML frontmatter + body
+    (optional) reference/  # supplementary docs
+```
+
+`SKILL.md`:
+
+```markdown
+---
+name: legal-rag
+description: Retrieval prompts tuned for legal documents
+---
+# Instructions body
+...
+```
+
+## Bundled skills
+
+| Name | Description |
+|---|---|
+| `legal-rag` | Citations, § sections, no legal advice |
+| `code-rag` | Symbol grounding, file:line refs, hybrid search |
+| `medical-rag` | Disclaimers, evidence levels |
+| `research-rag` | Multi-paper synthesis, citation-per-bullet |
+
+## Add to project
+
+```bash
+perfectrag add skill legal-rag --project .
+```
+
+Copies skeleton vào `skills/<name>/` trong project. Tự viết skill của bạn → tạo `skills/<tên>/SKILL.md` thủ công.
+
+## Mount point
+
+Tất cả templates mount `./skills` read-only vào container (path tuỳ backbone):
+- `ragflow-stack`: `/ragflow/skills`
+- `lightrag-stack`: `/app/skills`
+- `dify-stack`: `/app/skills`
+- `custom-naive-rag`: `/app/skills`
+
+Backbone/UI hiện chưa auto-discover skills từ disk — user dán nội dung `SKILL.md` vào system prompt khi tạo Agent/Assistant, hoặc customize template để đọc skills tự động.

perfectrag-0.1.0/docs/templates.md

@@ -0,0 +1,75 @@
+# Templates
+
+Mỗi template là một thư mục Copier chứa docker-compose + env + skeleton files. Được render với 3 context namespaces: `recipe`, `hw`, `answers`.
+
+## Available
+
+### custom-naive-rag
+
+Minimal DIY stack cho CPU-only / learning.
+
+- **Services**: Qdrant, Ollama, FastAPI app, open-webui, ollama-pull helper
+- **UI**: open-webui tại `:3000`, FastAPI `/docs` tại `:8000`
+- **Ingest**: `POST /ingest` (multipart file)
+- **Query**: `POST /query` JSON hoặc OpenAI-compatible `/v1/chat/completions`
+- **Khi nào chọn**: CPU-only + corpus nhỏ + qa_docs
+
+### ragflow-stack
+
+Production-grade RAG với hybrid search, deep doc parsing, agentic, MCP-native.
+
+- **Backbone**: [RAGFlow v0.17.2](https://github.com/infiniflow/ragflow)
+- **Services**: Elasticsearch, MySQL, Redis, MinIO, Ollama, ragflow-server
+- **UI**: RAGFlow Console tại `:80`
+- **Khi nào chọn**: Q&A hybrid search, cần ingest PDF phức tạp, cần agent + tool-calling, team/production
+
+### lightrag-stack
+
+GraphRAG cost-efficient với dual-level retrieval.
+
+- **Backbone**: [LightRAG](https://github.com/HKUDS/LightRAG)
+- **Services**: Ollama, lightrag server, open-webui chat
+- **UI**: LightRAG WebUI tại `:9621` (graph visualize + ingest), open-webui tại `:3000`
+- **Modes**: `naive`, `local`, `global`, `hybrid`
+- **Khi nào chọn**: multi-hop reasoning, knowledge graph, cần entity/relation
+
+### dify-stack
+
+Visual workflow + agent builder với marketplace.
+
+- **Backbone**: [Dify v1.3.1](https://github.com/langgenius/dify)
+- **Services**: Postgres, Redis, Qdrant, Ollama, api, worker, web, nginx
+- **UI**: Dify Console tại `:80`
+- **Khi nào chọn**: workflow/chatflow bằng UI kéo-thả, team không code
+
+## Contribute a template
+
+1. Tạo thư mục `src/perfectrag/templates/<name>/`
+2. Add `copier.yml`:
+   ```yaml
+   _templates_suffix: .jinja
+   _envops: { keep_trailing_newline: true }
+   _answers_file: .copier-answers.yml
+   _exclude: [copier.yml, __init__.py]
+   project_name: { type: str, default: my-rag }
+   ```
+3. Add template files với extension `.jinja`: `docker-compose.yml.jinja`, `.env.jinja`, `README.md.jinja`, `mcp.yaml.jinja`.
+4. Dùng variables: `{{ recipe.llm_model }}`, `{{ hw.gpu_vendor }}`, `{{ answers.use_case }}`.
+5. Add entry vào `_DESCRIPTIONS` trong `src/perfectrag/scaffolder.py`.
+6. (Optional) Update `_pick_template()` trong `src/perfectrag/recipes.py` để wizard tự gợi ý template mới cho use-case nào.
+7. Add test fixture + e2e test trong `tests/e2e/test_scaffold.py`.
+
+## Template variables reference
+
+Recipe (`recipe.*`):
+- `template`, `llm_model`, `llm_runtime`, `embedding_model`, `reranker`
+- `vector_db`, `doc_parser`, `chunk_strategy`, `chunk_size`
+- `gpu_enabled`, `vram_cap_gb`
+- `extras.enable_graphrag`, `extras.enable_hybrid_search`
+
+Hardware (`hw.*`):
+- `os`, `arch`, `cpu_model`, `cpu_cores`, `ram_gb`, `disk_free_gb`
+- `gpu_vendor` (`nvidia`/`amd`/`apple`/`none`), `gpu_name`, `vram_gb`, `cuda_version`
+
+Answers (`answers.*`):
+- `use_case`, `modality` (list), `privacy`, `multi_hop`, `corpus_size`, `user_scale`

perfectrag-0.1.0/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "perfectrag"
+version = "0.1.0"
+description = "Dynamic RAG framework scaffolder — wizard-driven, hardware-aware, docker-ready"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Apache-2.0" }
+authors = [{ name = "perfectRAG" }]
+keywords = ["rag", "graphrag", "scaffolder", "wizard", "docker", "mcp", "ollama"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "typer>=0.12",
+    "InquirerPy>=0.3.4",
+    "copier>=9.3",
+    "jinja2>=3.1",
+    "psutil>=5.9",
+    "nvidia-ml-py>=12.535",
+    "py-cpuinfo>=9.0",
+    "pyyaml>=6.0",
+    "rich>=13.7",
+    "distro>=1.9",
+    "pydantic>=2.6",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-mock>=3.12",
+    "ruff>=0.5",
+    "mypy>=1.10",
+    "types-PyYAML",
+]
+
+[project.scripts]
+perfectrag = "perfectrag.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/your-org/perfectrag"
+Issues = "https://github.com/your-org/perfectrag/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/perfectrag"]
+include = [
+    "src/perfectrag/**/*.py",
+    "src/perfectrag/templates/**/*",
+]
+artifacts = [
+    "src/perfectrag/templates/**/*",
+]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/perfectrag",
+    "README.md",
+    "pyproject.toml",
+    "tests",
+    "docs",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "C4", "SIM", "RUF"]
+# B008 — Typer uses callable defaults as its idiom
+# SIM105 — try/except/pass is clearer than contextlib.suppress here
+# SIM117 — nested with-statements are sometimes clearer
+# C401 — generator vs set comprehension nit
+ignore = ["E501", "B008", "SIM105", "SIM117", "C401", "RUF012"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra -q"

perfectrag-0.1.0/src/perfectrag/__init__.py

@@ -0,0 +1,3 @@
+"""perfectRAG — dynamic RAG framework scaffolder."""
+
+__version__ = "0.1.0"