---
title: BharatLingo AI
emoji: 🌐
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: true
license: mit
short_description: Free AI language tools for Indian languages
tags:
  - translation
  - grammar
  - indian-languages
  - nlp
---

# 🇮🇳 BharatLingo AI API

Free AI-powered language tools for all Indian languages.

## Setup

### Required Environment Variables

**DEEPSEEK_API_KEY**: Your DeepSeek API key for translation fallback
- Get your free API key from: https://platform.deepseek.com/
- Set in HuggingFace Space Settings → Repository secrets → Add secret
- Name: `DEEPSEEK_API_KEY`
- Value: Your API key (e.g., `sk-xxxxxxxxxxxxx`)

Without this key, the Space will work but translation fallback will be unavailable.

## Features

- **Translation**: Translate between 13+ Indian languages using IndicTrans2
- **Grammar Checker**: Fix grammar errors in your text
- **Spell Checker**: Correct spelling mistakes
- **Text Rewriter**: Rewrite text in different styles (formal, casual, professional)
- **Summarizer**: Summarize long texts
- **Paraphraser**: Paraphrase while keeping meaning

## Supported Languages

- English, Hindi, Bengali, Tamil, Telugu, Marathi, Gujarati
- Kannada, Malayalam, Punjabi, Odia, Assamese, Bhojpuri

## API Usage

This Space exposes API endpoints that can be called from any application:

### Translation
```python
from gradio_client import Client

client = Client("YOUR_USERNAME/bharatlingo-ai")
result = client.predict(
    text="Hello, how are you?",
    source_lang="english",
    target_lang="hindi",
    api_name="/translate"
)
```

### Grammar Check
```python
result = client.predict(
    text="She don't likes apples.",
    language="english",
    api_name="/grammar"
)
```

### JavaScript/Fetch API
```javascript
const response = await fetch('https://YOUR_USERNAME-bharatlingo-ai.hf.space/api/translate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    data: ["Hello world", "english", "hindi"]
  })
});
const result = await response.json();
```

## Models Used

- **Translation**: ai4bharat/indictrans2 (fallback: facebook/nllb-200)
- **Grammar**: grammarly/coedit-large
- **Text Generation**: google/flan-t5-base

## Credits

- [AI4Bharat](https://ai4bharat.org/) for IndicTrans2 models
- [Hugging Face](https://huggingface.co/) for hosting
- Built for [BharatLingo.com](https://bharatlingo.com)