{"id":47685698,"url":"https://github.com/sunilp/agentic-ai","last_synced_at":"2026-04-02T14:49:12.756Z","repository":{"id":347095755,"uuid":"1192341027","full_name":"sunilp/agentic-ai","owner":"sunilp","description":"A practical field guide to building reliable, evaluable, and production-grade agentic AI systems","archived":false,"fork":false,"pushed_at":"2026-03-27T06:37:41.000Z","size":3518,"stargazers_count":0,"open_issues_count":6,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-27T06:48:51.097Z","etag":null,"topics":["agent-architecture","agent-evaluation","agentic-ai","ai-agents","ai-engineering","ai-safety","artificial-intelligence","book","evaluation","field-guide","generative-ai","human-in-the-loop","large-language-models","llm","multi-agent-systems","production-ai","python","reliability-engineering"],"latest_commit_sha":null,"homepage":"https://sunilprakash.com/agentic-ai/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sunilp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-26T05:47:13.000Z","updated_at":"2026-03-27T06:36:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sunilp/agentic-ai","commit_stats":null,"previous_names":["sunilp/agentic-ai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/sunilp/agentic-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunilp%2Fagentic-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunilp%2Fagentic-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunilp%2Fagentic-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunilp%2Fagentic-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sunilp","download_url":"https://codeload.github.com/sunilp/agentic-ai/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunilp%2Fagentic-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31308446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-architecture","agent-evaluation","agentic-ai","ai-agents","ai-engineering","ai-safety","artificial-intelligence","book","evaluation","field-guide","generative-ai","human-in-the-loop","large-language-models","llm","multi-agent-systems","production-ai","python","reliability-engineering"],"created_at":"2026-04-02T14:49:12.189Z","updated_at":"2026-04-02T14:49:12.749Z","avatar_url":"https://github.com/sunilp.png","language":"Python","readme":"# Agentic AI for Serious Engineers\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/cover.svg\" alt=\"Agentic AI for Serious Engineers\" width=\"360\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.amazon.com/dp/B0GVG6848F\"\u003e\u003cimg src=\"https://img.shields.io/badge/Get_the_Book-Amazon-FF9900?style=flat-square\u0026logo=amazon\" alt=\"Available on Amazon\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sunilp/agentic-ai\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue?style=flat-square\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**A practical field guide to building reliable, evaluable, and production-grade agent systems.**\n\n**[Get the book on Amazon](https://www.amazon.com/dp/B0GVG6848F)**\n\n---\n\nThis repository is the **code companion** to *Agentic AI for Serious Engineers*. It contains working Python implementations, architecture diagrams, evaluation harnesses, and end-to-end projects that accompany the book.\n\nThe book teaches you when to build an agent, when not to, and how to make the ones you build survive production. The code here lets you run every concept hands-on.\n\n## New to agentic AI?\n\nStart with the **Foundations** -- four hands-on sections that take you from zero to building your first agent. No framework required. No prior AI experience needed.\n\n| # | Section | What you learn |\n|---|---------|----------------|\n| 0a | [How LLMs Actually Work](docs/book/00a-how-llms-work.md) | The engineer's mental model: APIs, tokens, context, hallucination |\n| 0b | [From API Calls to Tool Use](docs/book/00b-api-to-tools.md) | Function calling, schema validation, giving the model hands |\n| 0c | [Your First Agent, No Framework](docs/book/00c-first-agent.md) | Build a complete agent in 100 lines. See it work. See it break. |\n| 0d | [The Same Agent, With a Framework](docs/book/00d-frameworks.md) | ADK and LangChain side-by-side. Eval comparison. Choose with data. |\n\n## What is in this repo\n\n- **Working code for every chapter** -- tool registries, context pipelines, agent loops, multi-agent orchestration, human-in-the-loop gates, evaluation harnesses, and security hardening\n- **Two end-to-end projects** -- Document Intelligence Agent and Incident Runbook Agent\n- **52+ passing tests** -- unit and integration tests for every module\n- **22 architecture diagrams** -- hand-crafted SVGs covering system types, coordination patterns, trust boundaries, and failure surfaces\n- **Evaluation evidence** -- baseline eval reports, architecture comparisons, traced execution examples, and failure case studies\n\n## The Book\n\nSeven chapters covering the full lifecycle of building production agent systems.\n\n| # | Chapter | Focus |\n|---|---------|-------|\n| 1 | What \"Agentic\" Actually Means | Precise definitions, comparison table, decision map |\n| 2 | Tools, Context, and the Agent Loop | Tool registry, context pipeline, first working agent |\n| 3 | Workflow First, Agent Second | Same task two ways -- the key architectural decision |\n| 4 | Multi-Agent Systems Without Theater | Coordination patterns that solve real problems, not demos |\n| 5 | Human-in-the-Loop as Architecture | Approval gates, escalation policy, and audit trails |\n| 6 | Evaluating and Hardening Agents | Eval, tracing, reliability, cost, security |\n| 7 | When Not to Use Agents | The signature chapter -- building engineering judgment |\n\n**[Read the free sample chapter](docs/book/01-what-agentic-means.md)** or **[get the full book on Amazon](https://www.amazon.com/dp/B0GVG6848F)**.\n\n## Getting Started\n\n```bash\n# Install\nmake install\n\n# Run tests (52+ passing)\nmake test\n\n# Run the Document Intelligence Agent\nmake run\n\n# Run the eval harness\nmake eval\n```\n\nCopy `.env.example` to `.env` and add your API key before running.\n\n## Repo Structure\n\n```\n├── src/                           # Working examples, per-chapter\n│   ├── shared/                    # Model client, config, common types\n│   ├── ch02/                      # Tool registry, context pipeline, first agent\n│   ├── ch03/                      # Workflow vs agent comparison, state, planning\n│   ├── ch04_multiagent/           # Multi-agent contracts, agents, orchestrator\n│   ├── ch05_hitl/                 # Approval gates, escalation, audit logging\n│   └── ch06/                      # Eval harness, traces, reliability, security\n├── project/                       # End-to-end projects\n│   ├── doc-intelligence-agent/    # Ingestion, retrieval, citations, escalation\n│   └── incident-runbook-agent/    # Multi-agent with human approval\n├── tests/\n│   ├── unit/                      # Component-level tests\n│   └── integration/               # Pipeline and system tests\n├── docs/\n│   ├── book/                      # Sample chapter + chapter summaries\n│   ├── diagrams/                  # Architecture-grade SVG diagrams\n│   ├── projects/                  # Project documentation\n│   └── proof/                     # Evaluation evidence and analysis\n├── pyproject.toml                 # Dependencies\n├── Makefile                       # install, test, eval, run, compare, serve\n└── PRINCIPLES.md                  # Engineering principles\n```\n\n## Who This Is For\n\nBackend engineers, platform engineers, staff+ engineers, software architects, and technical leads building AI systems for production use.\n\n**Assumed baseline:** APIs, Python, software architecture, services, testing, databases, production experience.\n\n**Not assumed:** Transformers, embeddings, agent orchestration, AI evaluation. These are taught in the book.\n\n## Author\n\nWritten by [Sunil Prakash](https://sunilprakash.com) -- engineering leader focused on enterprise AI systems, governance, and agent architecture.\n\n## License\n\nCode in this repository is licensed under MIT. The book text is copyright Sunil Prakash -- [available on Amazon](https://www.amazon.com/dp/B0GVG6848F).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunilp%2Fagentic-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsunilp%2Fagentic-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunilp%2Fagentic-ai/lists"}