Nautil Helper
Built with Claude (Anthropic SDK), Python, FastAPI, React, TypeScript
- The need
- Understanding a production bug in the hotel connectivity stack meant cross-checking several code repositories, each supplier’s documentation and the database. Slow, and only possible for people who knew the whole ecosystem.
- What the tool does
- Nautil Helper is a multi-agent AI assistant I designed and built on my own initiative. It answers the team’s technical questions, diagnoses production bugs and writes the tickets.
- specialised agents, coordinated by an orchestrator
- 4
- code repositories covered (.NET, React, back office, docs)
- 6
- suppliers documented, PDFs converted to Markdown
- 4
- Claude models, picked per task
- 3
helper diagnose booking-api.log
[ERROR] 09:42:11 BookingService Supplier B: price mismatch on booking 48213 (contract 1240 EUR, supplier 1410 EUR)
Orchestrator question routed to Code Expert
Code Expert reads the Supplier B connector passenger mapping and their API docs
Diagnosis non-standard OTA child age code, counted as an adult: the supplier price is wrong
Ticket Agent ticket written: cause, files involved, proposed fix, test case
Diagnosis complete
Fictional log, booking and documentation, to show how it works.
In detail
- An orchestrator routes each question to the right agent.
- A Code Expert agent explores the code: file reading, ripgrep search, supplier API documentation.
- A QA agent reviews code changes.
- A Ticket agent writes structured tickets.
- Cross-analysis of code, supplier docs and SQL Server queries. Real cases: price gaps between connectivity and contract, non-standard OTA age codes, passenger types overwritten on the front end.
How I built it with AI
- Multi-agent architecture with the Anthropic SDK and Claude tool use.
- The right model for each agent (Opus, Sonnet or Haiku), balancing cost and quality.
- Knowledge base: Beachcomber, Koedia, Tahiti Nui Travel / Tourplan and Juniper docs converted automatically from PDF to Markdown, plus a knowledge sheet written for each repository, injected into the agents’ context.
- FastAPI back end (Python 3.12, async, SSE streaming), React, TypeScript, Vite and Tailwind front end, SQLite persistence.
- Workflow industrialised with Claude Code: Jira ticket creation (REST API v3), Bitbucket access, Microsoft Teams notifications (Adaptive Cards).