GoTamil API

AI-powered Tamil language proofreading and essay critique.

What is GoTamil API?

GoTamil API is a multi-tenant, production-grade backend service for Tamil language content processing. It provides AI-powered proofreading and essay critique capabilities, backed by Google Gemini models with a Bring Your Own Key (BYOK) credential model.

Key Features

• Proofread — Grammar, spelling, and style analysis grounded in classical Tamil rules (Tholkappiyam, Nannool, Sandhi/Punarchi)
• Essay Critique — Comprehensive academic feedback across structure, clarity, fact verification, and literary citations
• Async Processing — Automatic sync/async routing with operation polling
• BYOK — Bring Your Own Key credential management for Google Gemini
• Multi-tenant — Full tenant isolation with OIDC-based auth and RBAC
• Idempotent — Safe request retries via Idempotency-Key header

Quick Links

• Quickstart Guide — Get your first API call running
• API Reference — Full endpoint documentation
• Authentication — Auth setup and OIDC tokens
• BYOK Setup Guide — Configure your Gemini API key

Architecture at a Glance

Clients / NIMIR
    │ OIDC Bearer Token
    ▼
GoTamil API (Cloud Run)
    ├── /v1/proofread
    ├── /v1/essay-critique
    ├── /v1/operations/:id
    └── /v1/admin/*
         │
    ┌────┴────┐
    ▼         ▼
Supabase   Google Gemini
PostgreSQL   API (BYOK)

Stack: Node.js 22, TypeScript, Fastify, Prisma, Google Cloud Run, Cloud Tasks, Secret Manager.