agtcld

AgentCloud AI

Your private cloud solutions agent — ask how-tos with cited steps, then watch it design the architecture in live 3D. Grounded in official cloud docs. Runs on your machine.

▶ Try the live 3D demo · Install · What makes it different · Cloud support

AgentCloud answers questions about building on the cloud from the official documentation — every step cites the exact source page, so you get real APIs and real steps, not hallucinations. Ask a how-to and get cited steps; say "design …" and it proposes a full architecture (components, data flow, trade-offs, the questions it needs answered) and renders it as an interactive 3D diagram you can orbit and zoom. It runs locally with an embedded vector store — no database, no Docker, your questions stay yours.

AWS is available today. Azure & Google Cloud are coming next — same agent, same 3D designs, grounded in each provider's docs.

Install

pip install agtcld
agtcld            # shows the logo, asks: work in the terminal, or open the web app?

Only Python 3.10+ is required — no Docker, no database. On first run it asks for your LLM key and explains storage.

• Terminal mode → an interactive agent in your shell ((~) agentcloud >).
• Web app → http://127.0.0.1:8000 with the live 3D architecture view (rag-app serve, or choose "web").

What makes it different

Cloud support

Quickstart with your own docs

pip install agtcld
# put your PDFs / TXT / MD in ./data/raw, then:
rag-app index                       # chunk + embed locally (GPU-accelerated if available)
rag-app ask "What does our return policy say about refunds?"
rag-app serve                       # or launch the web UI

ask/design need an LLM — set OPENAI_API_KEY (in .env or your shell), or point RAG_LLM_PROVIDER=vllm at your own server. Indexing needs no API key (local embedding model).

Or load AWS's docs (373 services)

rag-app download --csv aws_service_guides.csv        # or --service "AWS Lambda" for a subset
rag-app index
rag-app ask "How do I enable S3 versioning?" --filter service="Amazon Simple Storage Service"

Every chunk is tagged with its service, so you can scope any question to one service. The CSVs (service guides, whitepapers, Well-Architected, prescriptive guidance) were generated from AWS's documentation sitemap.

How it works

INDEX:   your docs ──▶ parse (PyMuPDF) ──▶ chunk ──▶ embed ──▶ store (Chroma / pgvector)
ANSWER:  question ──▶ multi-query retrieval ──▶ rerank ──▶ cited answer  (+ grounding repair)
DESIGN:  request  ──▶ retrieve across services ──▶ components + flow + trade-offs ──▶ 3D diagram

Feedback & RLHF

Interactions and feedback are captured locally for continuous improvement:

rag-app feedback            # stats (👍/👎, corrections)
rag-app feedback --export   # → sft.jsonl (prompt→response) + preferences.jsonl (chosen/rejected)

Opt-in automated collection: set RAG_FEEDBACK_SUBMIT=true and RAG_FEEDBACK_ENDPOINT=<your collector> (PII-scrubbed before upload). Host the collector with rag-app collect-server.

Configuration (selected)

All settings are env vars with the RAG_ prefix (or a .env file):

Advanced

pip install "agtcld[browser]" && playwright install chromium
rag-app crawl https://aws.amazon.com/whitepapers/ --limit 5

docker compose up -d --build
docker compose exec app rag-app index

rag-app eval --file eval/architecture_questions.jsonl     # recall@k / precision@k / MRR
rag-app eval-answers --judge                               # LLM-judged step coverage

Contributing

Issues and PRs welcome — new cloud providers, site adapters, chunking/retrieval strategies, and eval sets especially. pip install -e ".[dev]" then pytest.

License

MIT © Ruturaj Dixit