{
  "markdown": "# Practical LLM Apps\n\n**Clone-and-run AI agents, RAG apps, and MCP servers.**\n\nHand-built examples you can customize and ship — not slide-deck demos.\n\nWorks with OpenAI, and several apps run fully local with no API key.\n\n---\n\n## Run one now\n\n### Invoice Follow-up Agent\n\n```bash\ngit clone https://github.com/nimish14/practical-llm-apps.git\ncd practical-llm-apps/starter_ai_agents/invoice_followup_agent\npip install -r requirements.txt\ncp .env.example .env   # add OPENAI_API_KEY\nstreamlit run app.py\n```\n\n### Chat with PDF\n\n```bash\ncd practical-llm-apps/starter_ai_agents/chat_with_pdf\npip install -r requirements.txt\ncp .env.example .env   # add OPENAI_API_KEY\nstreamlit run app.py\n```\n\n### Resume Evidence RAG (no API key)\n\n```bash\ncd practical-llm-apps/rag_apps/resume_evidence_rag\npip install -r requirements.txt\nstreamlit run app.py\n```\n\n### Freelance Ops MCP (Cursor / Claude)\n\n```bash\ncd practical-llm-apps/mcp_servers/freelance-ops-mcp\nnpm install\nnpm run build\nnpx -y @modelcontextprotocol/inspector node dist/index.js\n```\n\nAdd to Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"freelance-ops\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"freelance-ops-mcp\"]\n    }\n  }\n}\n```\n\n*(After `npm publish` — until then, point `args` at `node` + local `dist/index.js`.)*\n\n---\n\n## Browse templates\n\n### Starter AI Agents\n\n| App | Description |\n|-----|-------------|\n| [Invoice Follow-up Agent](starter_ai_agents/invoice_followup_agent/) | Draft polite → firm invoice reminders with tone control and overdue context |\n| [Chat with PDF](starter_ai_agents/chat_with_pdf/) | Ask questions about an uploaded PDF with page citations |\n\n### RAG Apps\n\n| App | Description |\n|-----|-------------|\n| [Resume Evidence RAG](rag_apps/resume_evidence_rag/) | Hybrid MiniLM + BM25 retrieval that returns grounded resume facts for a job description |\n\n### MCP Servers\n\n| Server | Description |\n|--------|-------------|\n| [freelance-ops-mcp](mcp_servers/freelance-ops-mcp/) | Tools for overdue status, tone suggestion, and invoice reminder drafts |\n| [resume-evidence-mcp](mcp_servers/resume-evidence-mcp/) | BM25 resume evidence retrieval tools for coding agents |\n\n---\n\n## Project goals\n\n1. Every app: **clone → install → run** in under 2 minutes\n2. Clear README with problem, pipeline, and limits\n3. MCP servers packaged for npm + MCP Registry\n4. Prefer small, focused tools over mega-frameworks\n\n---\n\n## License\n\nMIT — fork it, ship it, sell it.\n",
  "bytes": 2443,
  "sha": "c117b36651fde03df810dc2c720e711506cacfef8632e40afaa349c6c39df20e",
  "repo_slug": "nimish14/practical-llm-apps",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nimish14_freelance_ops_mcp_66dff0e5/readme"
}