Skip to content

yigagilbert/translate-sunbird-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Here is the final, professionally enhanced README file for your translation API repository, including details on translations between the local languages available through the Sunbird AI API.

# Sunbird AI Translation API

Welcome to the official repository for integrating the Sunbird AI Translation API. This powerful API leverages Sunbird's state-of-the-art language models to provide robust translation capabilities between English and multiple local languages, as well as direct translations between the local languages themselves.

## About Sunbird AI

Sunbird AI commits to democratizing access to cutting-edge artificial intelligence technologies. It specializes in developing language models that facilitate communication across a diverse range of linguistic landscapes, thus supporting both educational initiatives and commercial enterprises.

### Supported Translation Models

The API supports the following translation capabilities:
- **English to Local Languages**: Enables translations from English to Acholi, Ateso, Luganda, Lugbara, and Runyankole.
- **Local Languages to English**: Facilitates translations from the aforementioned local languages back to English.
- **Inter-Local Language Translation**: Provides translation services between the local languages themselves, enhancing communication within regional linguistic groups.

### Language Codes

To facilitate translations, the following codes are used to specify the source and target languages:
- `{ label: 'English', value: 'eng' }`
- `{ label: 'Luganda', value: 'lug' }`
- `{ label: 'Acholi', value: 'ach' }`
- `{ label: 'Ateso', value: 'teo' }`
- `{ label: 'Lugbara', value: 'lgg' }`
- `{ label: 'Runyankole', value: 'nyn' }`

## API Endpoint

Translations are conducted through the following endpoint:

const translationUrl = 'https://api.sunbird.ai/tasks/nllb_translate';


## Getting Started

### Prerequisites

Ensure you have a modern web browser installed and an active internet connection to access the API.

### Obtaining an API Token

Access to the Sunbird AI Translation API requires an API token. To obtain your token, create an account at:
[Sunbird AI API Login](https://api.sunbird.ai/login)

### Installation

To set up the local environment for translation:
1. **Clone the repository**:
   ```bash
   git clone https://github.com/yigagilbert/translate-sunbird-api.git
   cd translate-sunbird-api
  1. Launch the Application: Open the translate.html file in your browser to begin translating.

Usage

Input the text for translation in the provided text area, select the appropriate source and target languages using their codes, and click the "Translate" button. The translation results will be displayed immediately below the form.

Features

  • Intuitive User Interface: Designed for ease of use.
  • Comprehensive Language Support: Translates between English and multiple local languages, as well as between the local languages themselves.
  • Instant Results: Translations are performed in real-time.

Contributing

We welcome contributions to enhance the functionality and coverage of this translation tool. Follow these steps to contribute:

  1. Fork the repository.
  2. Create your feature branch (git checkout -b feature/YourAmazingFeature).
  3. Commit your changes (git commit -m 'Add some YourAmazingFeature').
  4. Push to the branch (git push origin feature/YourAmazingFeature).
  5. Submit a pull request.

Acknowledgments

  • Thanks to Sunbird AI for providing the foundational technology.
  • Appreciation to all contributors who have invested their time in improving this project.

We hope this tool enhances your ability to communicate across different languages effectively!


### Notes for Use
- **Repository URL and Directory**: Replace placeholders with actual values pertinent to your project.
- **License and Acknowledgments**: Adjust these as necessary to reflect your project's specifics and contributors accurately.

This README is designed to be both informative and professional, offering users and developers all the necessary information to effectively utilize and contribute to the translation tool.

About

sunbird-translate-one-page-html-and-javascript-demo

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages