Getting Started

Build powerful educational applications with our RAG-powered API for Sri Lankan curriculum content. Every response includes verifiable citations from official educational documents.

What is BrainUs API?

BrainUs API provides programmatic access to a comprehensive database of Sri Lankan educational content spanning grades 6-13. Our retrieval-augmented generation (RAG) system ensures that every answer comes with source citations, making it perfect for building trustworthy educational applications.

Key Features

• Verified Citations - Every response includes source documents and page references from official curriculum materials
• ** Curriculum Coverage** - 1,000+ indexed documents covering Grade 6-13 Sri Lankan syllabus across all subjects
• Production Ready - 99.9% uptime SLA with sub-500ms p95 latency. Battle-tested infrastructure
• ** Developer First** - REST API with Python and JavaScript SDKs, comprehensive docs, and OpenAPI spec

Quick Example

Here's a simple example of querying the BrainUs API:

curl -X POST https://api.brainus.lk/api/v1/dev/query \
  -H "X-API-Key: $BRAINUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Explain photosynthesis",
    "store_id": "default"
  }'

import os
import asyncio
from brainus_ai import BrainusAI

async def main():
    async with BrainusAI(api_key=os.getenv("BRAINUS_API_KEY")) as client:
        response = await client.query(
            query="Explain photosynthesis",
            store_id="default"
        )
        print(response.answer)

if __name__ == "__main__":
    asyncio.run(main())

import { BrainusAI } from '@brainus/ai';

const client = new BrainusAI({
  apiKey: process.env.BRAINUS_API_KEY
});

async function main() {
  const response = await client.query({
    query: 'Explain photosynthesis',
    storeId: 'default'
  });
  console.log(response.answer);
}

main();

Response:

{
  "answer": "Photosynthesis is the process by which green plants use sunlight to convert carbon dioxide and water into glucose and oxygen...",
  "citations": [
    {
      "document": "Grade 10 Science Textbook",
      "page": 45,
      "relevance": 0.95
    }
  ],
  "metadata": {
    "tokens_used": 150,
    "response_time_ms": 342
  }
}

API Plans

Choose the plan that fits your needs:

Next Steps

Ready to start building? Here's your roadmap:

Popular Resources

• Quick Start - Make your first API call in 5 minutes
• Authentication - Learn how to use API keys securely
• API Reference - Complete endpoint documentation
• Code Examples - Full examples in Python and JavaScript

Need Help?

• Browse our comprehensive documentation
• Join our Discord community
• Email us at developer@brainus.lk
• Report issues on GitHub