You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
#### 🌺🌸🌼 Bloom Your Internationalization Workflow! 🌷🌻🌹
4
4
5
-
#### 🎉 Now in Beta and Release Candidate (RC)!! 🎉
5
+
#### 🌟 Meet Our Smarter, Faster AI Language Engine! 🌟
6
6
7
-
(ʻŌlelo Honua can be translated to mean "World Language" or "Language Bridge" in Hawaiian.)
7
+
Ready to supercharge your i18n workflow? Our newly revamped AI language engine is here to make translations smarter, faster, and more intuitive. It delivers spot-on, culturally aware translations in record time, with built-in support for async and parallel processing. Whether you're scaling up or just starting out, this engine grows with you—making multilingual app development effortless and efficient. Say hello to the future of i18n!
8
8
9
9
## Simplify Your Internationalization Workflow with ʻŌlelo Honua
10
10
@@ -17,8 +17,11 @@ Why waste time on repetitive tasks when you can streamline your i18n process wit
17
17
## Challenges in Multilingual App Development and How ʻŌlelo Honua Solves Them
18
18
19
19
### Problem
20
+
20
21
Imagine building an app that speaks to the world. You start with one language, but as your app grows, so does the demand for multilingual support. Manually crafting and updating translation files for every new language? It’s a grind—tedious, error-prone, and a major time sink. Sound familiar?
21
22
23
+
With these models, ʻŌlelo Honua ensures you have access to the best tools for your internationalization needs, whether you're working on a small project or scaling to global audiences.
24
+
22
25
### Solution
23
26
24
27
Say goodbye to the headaches of managing translation files! ʻŌlelo Honua takes the grunt work out of internationalization by automating the creation and synchronization of translation files. With support for trusted providers like Google Translate, it ensures your translations are not only accurate but also always up-to-date. Save time, eliminate errors, and focus on what truly matters—building a world-class multilingual app.
@@ -30,21 +33,10 @@ Here's a simple illustration:
30
33
31
34
This automation makes it easier to manage internationalization in your application, allowing you to focus on other stuff!
32
35
33
-
### State Diagram
36
+
### Technical Deep Dive
34
37
35
38
For more details about my approach, vision, and methodology, refer to [About ʻŌlelo Honua](docs/ABOUT.md).
36
39
37
-
38
-
39
-
40
-
## Introducing Critiques
41
-
42
-
Critiques are a way to evaluate and improve the quality of translations by identifying areas where they may lack clarity, cultural accuracy, or grammatical correctness. ʻŌlelo Honua provides an optional feature to generate AI-powered critiques for translations, helping you refine and enhance your localization efforts.
43
-
44
-
### Example Critique
45
-
46
-
An example of an AI-generated critique can be seen [here](examples/basic/critiques/critique.en.haw.md).
47
-
48
40
## Installation
49
41
50
42
To install the library, use npm or yarn:
@@ -65,24 +57,28 @@ Here's how you use the library:
Then, use a library like `dotenv` to load the key into your application:
96
92
97
93
```javascript
98
-
require('dotenv').config();
94
+
require("dotenv").config();
99
95
constapiKey=process.env.OPENROUTER_API_KEY;
100
96
```
101
97
102
98
This approach keeps your sensitive information out of your codebase and makes it easier to manage across different environments.
103
99
104
-
You need to provide a configuration object and a translation provider. For instance, you can use the `DeepSeekProvider` as demonstrated in the usage example. I highly recommend DeepSeek & OpenRouter as these are free and extremely stable. Happy coding!
105
-
100
+
You need to provide a configuration object and a translation provider. For instance, you can use the `DeepSeekProvider` as demonstrated in the usage example. I highly recommend DeepSeek & OpenRouter as these are free and extremely stable. Happy coding!
106
101
107
102
## Configuration Example
108
103
109
104
Here is an example of full configuration options:
110
105
111
106
```javascript
112
-
const config:LocaleConfig= {
113
-
primeLanguage:"en",
114
-
includeLanguage: ["haw", "ar", "es", "fr"], // Specify languages to include
115
-
// Alternatively, you can use excludeLanguage: ["ja"] to exclude specific languages
116
-
bulkTranslate:true, // Use bulk translation for better performance (replaces useBulkProvider, which is being deprecated)
117
-
critique:true, // Enable AI critique for translations
118
-
saveCritique:false, // Optionally save critiques for further analysis
119
-
repair:false, // Enable or disable automatic repair of translations
120
-
debug:false, // Enable debug mode for detailed logs
121
-
multiLanguageAgreementThreshold:0.8, // Set threshold for multi-language agreement
122
-
loopRetryOptions: {
123
-
mainLoopRetries:3, // Number of retries for the main loop
124
-
critiqueLoopRetries:2, // Number of retries for critique loop
125
-
repairLoopRetries:1, // Number of retries for repair loop
107
+
const config:Config= {
108
+
primeLanguage:"en", // The primary language to use
maxChunkRequests:4, // Maximum number of chunk requests
125
+
additionalConfig: {
126
+
critique:true, // Enable AI critique for translations
127
+
saveCritique:false, // Optionally save critiques for further analysis
128
+
repair:false, // Enable or disable automatic repair of translations
129
+
multiLanguageAgreementThreshold:0.8, // Set threshold for multi-language agreement
126
130
},
127
131
};
128
132
```
129
133
130
-
###Supported Models
134
+
## Supported Providers
131
135
132
-
ʻŌlelo Honua supports a variety of translation providers, each tailored to specific use cases:
136
+
Olelo Honua integrates with OpenRouter, OpenAI/ChatGPT, Google Translate, and even local LLM providers.
133
137
134
-
-**OpenRouterProvider**: A free and reliable option for general-purpose translation tasks, ideal for developers seeking stability without additional costs.
135
-
-**DeepSeekProvider**: Highly recommended for its speed, accuracy, and cost-effectiveness, making it a great choice for production environments.
136
-
-**MultiLanguageProvider**: Specializes in handling translations for multiple languages simultaneously, ensuring consistency across diverse locales.
137
-
-**GemmaProvider**: Designed for high-quality translations, offering advanced features like context-aware adjustments and cultural sensitivity.
138
-
-**LlamaProvider**: Optimized for large-scale translation projects, suitable for applications with extensive multilingual content.
139
-
-**MistralProvider**: Provides robust and scalable translation capabilities, ideal for enterprise-level use cases and complex workflows.
140
-
-**QwenProvider**: Utilizes state-of-the-art translation technology, delivering precise and modern translations for cutting-edge applications.
141
-
-**GoogleTranslateProvider**: Leverages the well-known Google Translate API for dependable and widely supported translations.
142
-
-**OpenAIChatGPTProvider**: Uses OpenAI's ChatGPT to generate contextual and conversational translations, perfect for dynamic or interactive content.
143
-
-**ToyProvider**: A lightweight and simple provider intended for testing, prototyping, or development purposes.
138
+
### Supported Models
139
+
140
+
ʻŌlelo Honua integrates with a variety of models to streamline your translation workflow. Below is a list of supported models categorized by provider:
<metaname="description" content="A powerful i18n library for JavaScript, Node.JS, and TypeScript projects. Simplify internationalization with this npm dependency.">
<metaproperty="og:title" content="ʻŌlelo Honua: i18n Library for JavaScript/TypeScript/Node.JS">
11
-
<metaproperty="og:description" content="Simplify internationalization with this powerful i18n npm dependency for JavaScript, Node.JS, and TypeScript projects.">
0 commit comments