Markdown Converter
Agent skill for markdown-converter
**GOGGA** (π¦·) is a sovereign, bicameral AI platform designed specifically for the South African market. The name means "insect/grasshopper" in Afrikaans, reflecting its South African identity.
Sign in to like and favorite skills
GOGGA (π¦·) is a sovereign, bicameral AI platform designed specifically for the South African market. The name means "insect/grasshopper" in Afrikaans, reflecting its South African identity.
Core Value Proposition: High-performance, cost-optimized conversational AI with voice-first interactions, media generation, and document analysisβtailored for South Africa's 11 official languages and POPIA-compliant data handling.
Backend (FastAPI):
Frontend (Next.js 16):
Admin Panel:
Infrastructure:
GOGGA routes queries between two neural processing layers:
| Layer | Model | Speed | Use Cases |
|---|---|---|---|
| Speed Layer | Qwen 3 32B | ~2,600 tok/s | Greetings, simple queries, UI help |
| Complex Layer | Qwen 3 235B | ~1,400 tok/s | Legal analysis, coding, translation, constitutional law |
Routing Logic:
| Tier | Price (ZAR) | Text Tokens | Images | Video | RAG Docs |
|---|---|---|---|---|---|
| FREE | R0 | OpenRouter Qwen 235B | 1/day (watermarked) | 3s sample | β |
| JIVE | R99/mo | 500,000 tokens | 20/month | 5 sec | 1 doc, 5MB |
| JIGGA | R299/mo | 2,000,000 tokens | 70/month + 30 edits | 16 sec | 200 docs, 250MB |
Pricing Strategy: 47% gross margin on both paid tiers.
Image Generation (Imagen 3):
Video Generation (Veo 3.1):
Real-time voice conversations in all 11 SA official languages:
Languages: English, Afrikaans, isiZulu, isiXhosa, isiNdebele, Sepedi, Sesotho, Setswana, siSwati, Tshivenda, Xitsonga
Client-side RAG with two upload mechanisms:
Paperclip (Session Documents):
RAG Document Store (Persistent):
Supported Files:
.txt, .md, .markdown.pdf (with OCR).xlsx, .csv.py, .js, .ts, .java, etc..docx, .pptx.pages, .numbers, .keynoteTechnology:
PayFast integration (South African gateway):
Sidecar service running OptiLLM:
Frontend (Next.js) ββ Backend (FastAPI) β CePO Sidecar (OptiLLM) β Cerebras Cloud / OpenRouter Google Vertex AI (Imagen, Veo) Gemini Live API (GoggaTalk)
X-User-Tier headergogga-backend/ # FastAPI backend βββ app/ β βββ api/v1/endpoints/ # chat, payments, media, tools, etc. β βββ core/ # routing, security, exceptions β βββ models/ # Pydantic & SQLModel schemas β βββ services/ # AI, payments, cost tracking β βββ tools/ # Math, Python, web search β βββ jobs/ # Scheduled tasks βββ tests/ # Pytest test suite βββ Dockerfile # Production image gogga-frontend/ # Next.js frontend βββ src/ β βββ app/ # App Router pages β β βββ api/ # API routes (proxy, auth, internal) β β βββ dashboard/ # Analytics dashboard β β βββ login/ # Authentication β βββ components/ # React components β β βββ ChatComponents/ # Chat UI β β βββ MediaCreator/ # Image/Video studios β β βββ rag/ # RAG components β β βββ dashboard/ # Dashboard components β β βββ toolshed/ # Tool components β βββ hooks/ # Custom React hooks β βββ lib/ # Utilities & RxDB collections β βββ types/ # TypeScript definitions βββ prisma/ # Database schema βββ Dockerfile.dev # Development image gogga-admin/ # Admin panel gogga-cepo/ # CePO sidecar (OptiLLM) gogga-proxy/ # Network proxy docs/ # Comprehensive documentation βββ MEDIA_GENERATION_SYSTEM.md βββ RAG_SYSTEM_DESIGN.md βββ GoggaTalk.md βββ NEXTJS_16_IMPLEMENTATION.md docker-compose.yml # Local orchestration
# Start all services with hot reload docker-compose up --watch # Access points - Frontend: https://192.168.0.130:3000 - Backend: http://localhost:8000 - API Docs: http://localhost:8000/docs - Admin Panel: http://localhost:3100 - Health Check: http://localhost:8000/health
gogga-backend/.envdocker-compose.ymlDual-Database Architecture: Separation of identity (SQLite) and user content (RxDB/IndexedDB) for privacy and performance
Client-Side RAG: All document processing happens in-browser for privacy and offline capability
Bicameral AI Routing: Automatic query complexity detection to optimize cost and speed
Voice-First Design: GoggaTalk prioritizes spoken interactions for SA's mobile-first market
Local-First Storage: User content never leaves the device unless explicitly shared
Tier-Based Watermarking: FREE tier gets SynthID watermarks for content identification
CePO Enhancement: Sidecar service for improved reasoning without API changes
/TESTS/ directory/docs/MEDIA_GENERATION_SYSTEM.md - Image/video generation architecture/docs/RAG_SYSTEM_DESIGN.md - RAG system design/docs/GoggaTalk.md - Voice chat implementation/docs/NEXTJS_16_IMPLEMENTATION.md - Performance optimizations/docs/TIERS.md - Subscription tier detailsBackend:
gogga-backend/app/main.py - FastAPI entry pointgogga-backend/app/config.py - Configurationgogga-backend/app/api/v1/endpoints/ - API endpointsgogga-backend/app/services/ - Business logicFrontend:
gogga-frontend/src/app/ChatClient.tsx - Main chat UIgogga-frontend/src/components/ - React componentsgogga-frontend/package.json - Dependenciesgogga-frontend/next.config.js - Next.js configConfiguration:
docker-compose.yml - Service orchestrationREADME.md - Project overview/docs/ for architectural guidancehttp://localhost:8000/healthdocker-compose logsGOGGA is a production-ready, South African AI platform combining cutting-edge web technologies (Next.js 16, React 19) with robust backend services (FastAPI, Python 3.14). It demonstrates advanced software engineering practices including microservices architecture, local-first design, tier-based access control, and comprehensive test coverage. The project prioritizes voice-first interactions, cost optimization through bicameral AI routing, and POPIA-compliant data handling.