An opinionated FastAPI monorepo/boilerplate used by ZyntroAI as the foundation for production AI services, agent tooling, and reference documentation. The repo is a working collection: an OAuth2 PKCE API core, a GraphQL layer, a library of reusable AI-agent skills, packaged deliverable suites, and extensive docs.
This README reflects the repository as it stands. Individual suites carry their own READMEs with deeper detail.
| Path | Purpose |
|---|---|
app/ |
FastAPI application core (main.py, routers under api/, core config, services) |
graphql_api/ |
GraphQL service layer (Strawberry) |
main.py |
OAuth2 PKCE API entrypoint (/auth, /callback, /health) |
skills/ |
Reusable AI-agent skill definitions (e.g. fetching, changelog-auto-update, credential-management) |
deliverables/ |
Self-contained feature suites (security, notebooklm, gemini-cli, gh-devops-toolkit, azure-cli, agent-skill-template, …) |
docs/ |
Reference & knowledge documentation (GraphQL, FireCrawl, Google Chat, GitHub Actions, incident drills) |
helm/ |
Helm charts (OAuth app) |
k8s/ |
Kubernetes manifests |
tests/ |
Test suite (tests/ + per-suite tests) |
.github/workflows/ |
CI/CD, release drafter, auto-merge, secret-scan, coverage |
# create .env from the example, then:
docker compose up -d --build
# or run directly:
pip install -r requirements.txt
uvicorn main:app --reload- API docs:
http://localhost:8000/docs - Health:
http://localhost:8000/health
- FastAPI (async, auto OpenAPI) + Pydantic v2
- LangGraph / LangChain + OpenAI for agent workflows
- Strawberry GraphQL (
graphql_api/) - Redis / PostgreSQL integrations under
app/integrations - Docker + docker-compose, Helm/K8s for deployment
- Secret scanning, coverage, and a test suite run in CI.
- External-service failures fail open (graceful degradation).
- Secrets live only in environment / CI secrets — never in source.
- See
SECURITY.md(reporting),CONTRIBUTING.md(PRs),RELEASE.md(releases).
docs/— API, GraphQL, and reference guides.deliverables/— each suite ships its own README, SKILL.md, and tests.
See LICENSE.