# nerkooo agency — Web Design, Engineering & AI Solutions

Official machine-readable homepage representation for **nerkooo** (https://nerkooo.com).

## About the Agency

nerkooo is a boutique digital and software engineering agency focused on premium web applications, mobile platforms, and autonomous AI systems (voicebots, chatbots, and RAG architectures). Founded and led by Nermin Karić, the agency bridges high-end visual design with resilient full-stack engineering.

- **Founder & Lead Engineer:** Nermin Karić
- **Official Website:** [nerkooo.com](https://nerkooo.com)
- **Repository:** [GitHub: nerkooo97/nerkooo](https://github.com/nerkooo97/nerkooo)
- **Contact:** [nermin@nerkooo.com](mailto:nermin@nerkooo.com)
- **Developer Portal:** [nerkooo.com/developers](https://nerkooo.com/developers)
- **API Spec:** [nerkooo.com/openapi.json](https://nerkooo.com/openapi.json)

---

## Core Capabilities & Services

### 1. Web & Mobile App Development
- Modern responsive web platforms using Next.js 16, React 19, TypeScript, and Tailwind CSS.
- Cross-platform native mobile applications using React Native and Expo.
- Supabase backend architecture, PostgreSQL, Edge Functions, real-time sync.
- Cloud hosting, Docker containerization, and automated CI/CD deployment on Dokploy & Hetzner.

### 2. AI Voicebots & Inbound Phone Agents
- Real-time conversational AI phone receptionists with natural voice latency under 600ms.
- Automated appointment scheduling integrated directly into Google Calendar, Cal.com, or custom CRM.
- Native multilingual speech recognition and synthesis for English, Bosnian/Croatian/Serbian, and German.

### 3. AI Chatbots & RAG Systems
- Retrieval-Augmented Generation (RAG) connected to client documentation, product catalogs, and PDFs.
- Embeddable web widget with streaming responses and verified attribution.
- Intelligent lead qualification and escalation to human team members via email/Slack.

### 4. Turnkey Industry Solutions
- **Beauty Salons:** Mobile booking, automated WhatsApp reminders, client management.
- **Restaurants:** Interactive QR menus, table reservations, online food ordering.
- **Carpentry & Manufacturing:** Interactive portfolio visualizers, project cost estimators.

---

## Machine & Agent Navigation

- `GET /llms.txt` — Machine index and agent instructions
- `GET /pricing.md` — Machine-readable pricing tiers and scope breakdowns
- `GET /auth.md` — Agent authentication (WorkOS `agent_auth` spec)
- `GET /openapi.json` — OpenAPI 3.1.0 specification
- `POST /ask` — NLWeb natural-language query endpoint with SSE streaming
- `POST /api/mcp` — Streamable Model Context Protocol (MCP) server
- `POST /api/v1/contact` — Project inquiries and consultation intake