boffire commited on
Commit
d9b2c77
·
verified ·
1 Parent(s): 362c2fa

Update AGENTS.md

Browse files
Files changed (1) hide show
  1. AGENTS.md +29 -10
AGENTS.md CHANGED
@@ -1,13 +1,13 @@
1
  # AGENTS.md — LibreTranslate Kabyle Space
2
 
3
  ## Overview
4
- This Hugging Face Space hosts a LibreTranslate instance for **Kabyle (kab)** language translation.
5
- It provides a self-hosted translation API with experimental Kabyle language models.
6
 
7
  ## Space Details
8
  - **URL**: https://huggingface.co/spaces/boffire/libreTranslate_kabyle
9
  - **Runtime**: Docker Space (LibreTranslate)
10
- - **Languages**: Kabyle (kab) English
11
 
12
  ## API Endpoints
13
 
@@ -54,13 +54,32 @@ curl -X POST https://boffire-libretranslate-kabyle.hf.space/detect \
54
  curl https://boffire-libretranslate-kabyle.hf.space/languages
55
  ```
56
 
57
- ## Translation Models
58
- The space runs experimental Kabyle models:
59
- - Default is : kab
60
- - Model: `Kabyle (OS)` — trained with OpenSubtitles backtranslation data
61
- - Experimental variants: `kab_comp`, `kab_comp2`, `kab_all`, `kab_kab`
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
62
 
63
  ## Important Notes
64
  - The Space may go to sleep after inactivity (cold start ~30s)
65
- - Suggestions are stored in the dataset `boffire/libretranslate-en-kab-suggestions`
66
- - Language codes use `kab` for standard Kabyle
 
 
1
  # AGENTS.md — LibreTranslate Kabyle Space
2
 
3
  ## Overview
4
+ This Hugging Face Space hosts a LibreTranslate instance dedicated to **Kabyle (kab)** language translation.
5
+ It provides a self-hosted translation API with multiple experimental Kabyle language models.
6
 
7
  ## Space Details
8
  - **URL**: https://huggingface.co/spaces/boffire/libreTranslate_kabyle
9
  - **Runtime**: Docker Space (LibreTranslate)
10
+ - **Focus**: Kabyle language translation models only
11
 
12
  ## API Endpoints
13
 
 
54
  curl https://boffire-libretranslate-kabyle.hf.space/languages
55
  ```
56
 
57
+ ## Kabyle Translation Models
58
+
59
+ | Code | Name | Directionality |
60
+ |------|------|----------------|
61
+ | `kab` | Kabyle | **Bidirectional** with English: `en↔kab` |
62
+ | `kab_os` | Kabyle (OS) | **One-way only**: `en→kab_os` |
63
+ | `kab_comp` | Kabyle (Tasenselkimt) | **One-way only**: `en→kab_comp` |
64
+ | `kab_comp2` | Kabyle (TSSLKMT51000) | **One-way only**: `en→kab_comp2` |
65
+ | `kab_num` | Kabyle (num40000) | **One-way only**: `en→kab_num` |
66
+ | `kab_kab` | Kabyle 48500 (19082025) | **One-way only**: `en→kab_kab` |
67
+
68
+ ### Directionality Rules
69
+
70
+ - **Standard Kabyle (`kab`)**: Full bidirectional support with English.
71
+ - `en→kab` ✓ (English to Kabyle)
72
+ - `kab→en` ✓ (Kabyle to English)
73
+
74
+ - **Alternative Kabyle Models**: English can translate **into** these models, but they **cannot** translate back to English.
75
+ - `en→kab_os` ✓ | `kab_os→en` ✗
76
+ - `en→kab_comp` ✓ | `kab_comp→en` ✗
77
+ - `en→kab_comp2` ✓ | `kab_comp2→en` ✗
78
+ - `en→kab_num` ✓ | `kab_num→en` ✗
79
+ - `en→kab_kab` ✓ | `kab_kab→en` ✗
80
 
81
  ## Important Notes
82
  - The Space may go to sleep after inactivity (cold start ~30s)
83
+ - Suggestions are stored in the dataset `axxam/libretranslate-suggestions`
84
+ - Language code `kab` refers to the standard bidirectional Kabyle model
85
+ - All alternative models (`kab_os`, `kab_comp`, `kab_comp2`, `kab_num`, `kab_kab`) are **English-to-Kabyle only**