diff --git a/.github/workflows/generate-readme-translations.yml b/.github/workflows/generate-readme-translations.yml
index 9963e693549..00b10d58881 100644
--- a/.github/workflows/generate-readme-translations.yml
+++ b/.github/workflows/generate-readme-translations.yml
@@ -9,21 +9,27 @@ jobs:
         runs-on: ubuntu-latest
         strategy:
             matrix:
-                language: [
-                    {code: 'CN', name: 'Chinese'},
-                    {code: 'DE', name: 'German'},
-                    {code: 'ES', name: 'Spanish'},
-                    {code: 'FR', name: 'French'},
-                    {code: 'HE', name: 'Hebrew'},
-                    {code: 'IT', name: 'Italian'},
-                    {code: 'JA', name: 'Japanese'},
-                    {code: 'KOR', name: 'Korean'},
-                    {code: 'PTBR', name: 'Portuguese (Brazil)'},
-                    {code: 'RU', name: 'Russian'},
-                    {code: 'TH', name: 'Thai'},
-                    {code: 'TR', name: 'Turkish'},
-                    {code: 'VI', name: 'Vietnamese'}
-                ]
+                language:
+                    [
+                        { code: "CN", name: "Chinese" },
+                        { code: "DE", name: "German" },
+                        { code: "ES", name: "Spanish" },
+                        { code: "FR", name: "French" },
+                        { code: "HE", name: "Hebrew" },
+                        { code: "HU", name: "Hungarian" },
+                        { code: "IT", name: "Italian" },
+                        { code: "JA", name: "Japanese" },
+                        { code: "KOR", name: "Korean" },
+                        { code: "PTBR", name: "Portuguese (Brazil)" },
+                        { code: "RU", name: "Russian" },
+                        { code: "TH", name: "Thai" },
+                        { code: "TR", name: "Turkish" },
+                        { code: "VI", name: "Vietnamese" },
+                        { code: "AR", name: "Arabic" },
+                        { code: "RS", name: "Srpski" },
+                        { code: "TG", name: "Tagalog" },
+                        { code: "PL", name: "Polski" },
+                    ]
         permissions:
             contents: write
         steps:
@@ -36,32 +42,32 @@ jobs:
               uses: 0xjord4n/aixion@v1.2.1
               id: aixion
               with:
-                config: >
-                  {
-                    "provider": "openai",
-                    "provider_options": {
-                      "api_key": "${{ secrets.OPENAI_API_KEY }}"
-                    },
-                    "messages": [
+                  config: >
                       {
-                        "role": "system",
-                        "content": "You will be provided with a markdown file in English, and your task is to translate it into ${{ matrix.language.name }}."
-                      },
-                      {
-                        "role": "user",
-                        "content_path": "README.md"
+                        "provider": "openai",
+                        "provider_options": {
+                          "api_key": "${{ secrets.OPENAI_API_KEY }}"
+                        },
+                        "messages": [
+                          {
+                            "role": "system",
+                            "content": "You will be provided with a markdown file in English, and your task is to translate it into ${{ matrix.language.name }}."
+                          },
+                          {
+                            "role": "user",
+                            "content_path": "README.md"
+                          }
+                        ],
+                        "save_path": "i18n/readme/README_${{ matrix.language.code }}.md",
+                        "model": "gpt-4o"
                       }
-                    ],
-                    "save_path": "README_${{ matrix.language.code }}.md",
-                    "model": "gpt-4o"
-                  }
 
             # Upload each translated file as an artifact
             - name: Upload translation
               uses: actions/upload-artifact@v4
               with:
-                name: readme-${{ matrix.language.code }}
-                path: README_${{ matrix.language.code }}.md
+                  name: readme-${{ matrix.language.code }}
+                  path: README_${{ matrix.language.code }}.md
 
     commit:
         needs: translation
@@ -76,8 +82,8 @@ jobs:
             - name: Download all translations
               uses: actions/download-artifact@v4
               with:
-                pattern: readme-*
-                merge-multiple: true
+                  pattern: readme-*
+                  merge-multiple: true
 
             - name: Commit all translations
               uses: stefanzweifel/git-auto-commit-action@v5
diff --git a/README.md b/README.md
index 11066daffe4..547ecf354df 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@
 
 ## 🌍 README Translations
 
-[中文说明](./README_CN.md) | [日本語の説明](./README_JA.md) | [한국어 설명](./README_KOR.md) | [Français](./README_FR.md) | [Português](./README_PTBR.md) | [Türkçe](./README_TR.md) | [Русский](./README_RU.md) | [Español](./README_ES.md) | [Italiano](./README_IT.md) | [ไทย](./README_TH.md) | [Deutsch](./README_DE.md) | [Tiếng Việt](./README_VI.md) | [עִברִית](https://github.com/elizaos/Elisa/blob/main/README_HE.md) | [Tagalog](./README_TG.md) | [Polski](./README_PL.md) | [Arabic](./README_AR.md) | [Hungarian](./README_HU.md) | [Srpski](./README_RS.md)
+[中文说明](i18n/readme/README_CN.md) | [日本語の説明](i18n/readme/README_JA.md) | [한국어 설명](i18n/readme/README_KOR.md) | [Français](i18n/readme/README_FR.md) | [Português](i18n/readme/README_PTBR.md) | [Türkçe](i18n/readme/README_TR.md) | [Русский](i18n/readme/README_RU.md) | [Español](i18n/readme/README_ES.md) | [Italiano](i18n/readme/README_IT.md) | [ไทย](i18n/readme/README_TH.md) | [Deutsch](i18n/readme/README_DE.md) | [Tiếng Việt](i18n/readme/README_VI.md) | [עִברִית](i18n/readme/README_HE.md) | [Tagalog](i18n/readme/README_TG.md) | [Polski](i18n/readme/README_PL.md) | [Arabic](i18n/readme/README_AR.md) | [Hungarian](i18n/readme/README_HU.md) | [Srpski](i18n/readme/README_RS.md)
 
 ## 🚩 Overview
 
@@ -52,6 +52,7 @@ To ensure sustainable development and continued innovation, we ask contributions
 All contributions are publicly tracked on-chain and used exclusively for ecosystem development.
 
 ### ⚠️ Don't forget to tip the big guy 10%: ⚠️
+
 [AM84n1iLdxgVTAyENBcLdjXoyvjentTbu5Q6EpKV1PeG](https://solscan.io/account/AM84n1iLdxgVTAyENBcLdjXoyvjentTbu5Q6EpKV1PeG)
 
 ## 🚀 Quick Start
diff --git a/README_AR.md b/i18n/readme/README_AR.md
similarity index 90%
rename from README_AR.md
rename to i18n/readme/README_AR.md
index c2597ebf7bb..7748533aa53 100644
--- a/README_AR.md
+++ b/i18n/readme/README_AR.md
@@ -52,7 +52,7 @@ cp .env.example .env
 pnpm i && pnpm start
 ```
 
-تعلم أكثر عن كيفية تخصيص إليزا من هنا [التعليمات](https://elizaos.github.io/eliza/) 
+تعلم أكثر عن كيفية تخصيص إليزا من هنا [التعليمات](https://elizaos.github.io/eliza/)
 
 ### إذا كان لديك خبرة بالفعل، يُمكنك تشغيل إليزا يدويًا.
 
@@ -65,7 +65,7 @@ git clone https://github.com/elizaos/eliza.git
 git checkout $(git describe --tags --abbrev=0)
 ```
 
-### تشغل إليزا مع Gitpod 
+### تشغل إليزا مع Gitpod
 
 [![In Gitpod öffnen](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main)
 
@@ -92,11 +92,13 @@ sh scripts/start.sh
 افتح ملف agent/src/character.ts لتعديل الشخصية الافتراضية. قم بإلغاء التعليق وعدّل عليها.
 
 لتحميل شخصيات مخصصة
-   - استخدم الأمر "pnpm start --characters="path/to/your/character.json
-   - يُمكنك تحميل عدة ملفات للشخصيات في نفس الوقت.
+
+- استخدم الأمر "pnpm start --characters="path/to/your/character.json
+- يُمكنك تحميل عدة ملفات للشخصيات في نفس الوقت.
 
 الاتصال بـ X (تويتر):
-   - غيّر "clients": [] إلى "clients": ["twitter"] في ملف الشخصية للاتصال بـ X أو تويتر
+
+- غيّر "clients": [] إلى "clients": ["twitter"] في ملف الشخصية للاتصال بـ X أو تويتر
 
 ### لتشغيل إليزا يدويًا
 
@@ -119,7 +121,7 @@ pnpm install --include=optional sharp
 
 ### المجتمع والدعم
 
-- في حال إذا واجهت أي مشاكل تتعلق باستخدام إليزا ولتقديم المقترحات  [GitHub Issues](https://github.com/elizaos/eliza/issues). 
+- في حال إذا واجهت أي مشاكل تتعلق باستخدام إليزا ولتقديم المقترحات [GitHub Issues](https://github.com/elizaos/eliza/issues).
 - لمشاركة تطبيقاتك والتفاعل مع المجتمع [Discord](https://discord.gg/ai16z).
 
 ## المُساهمون
diff --git a/README_CN.md b/i18n/readme/README_CN.md
similarity index 100%
rename from README_CN.md
rename to i18n/readme/README_CN.md
diff --git a/README_DE.md b/i18n/readme/README_DE.md
similarity index 100%
rename from README_DE.md
rename to i18n/readme/README_DE.md
diff --git a/README_ES.md b/i18n/readme/README_ES.md
similarity index 100%
rename from README_ES.md
rename to i18n/readme/README_ES.md
diff --git a/README_FR.md b/i18n/readme/README_FR.md
similarity index 100%
rename from README_FR.md
rename to i18n/readme/README_FR.md
diff --git a/README_HE.md b/i18n/readme/README_HE.md
similarity index 100%
rename from README_HE.md
rename to i18n/readme/README_HE.md
diff --git a/README_HU.md b/i18n/readme/README_HU.md
similarity index 100%
rename from README_HU.md
rename to i18n/readme/README_HU.md
diff --git a/README_IT.md b/i18n/readme/README_IT.md
similarity index 100%
rename from README_IT.md
rename to i18n/readme/README_IT.md
diff --git a/README_JA.md b/i18n/readme/README_JA.md
similarity index 100%
rename from README_JA.md
rename to i18n/readme/README_JA.md
diff --git a/README_KOR.md b/i18n/readme/README_KOR.md
similarity index 100%
rename from README_KOR.md
rename to i18n/readme/README_KOR.md
diff --git a/README_PL.md b/i18n/readme/README_PL.md
similarity index 100%
rename from README_PL.md
rename to i18n/readme/README_PL.md
diff --git a/README_PTBR.md b/i18n/readme/README_PTBR.md
similarity index 100%
rename from README_PTBR.md
rename to i18n/readme/README_PTBR.md
diff --git a/README_RS.md b/i18n/readme/README_RS.md
similarity index 100%
rename from README_RS.md
rename to i18n/readme/README_RS.md
diff --git a/README_RU.md b/i18n/readme/README_RU.md
similarity index 100%
rename from README_RU.md
rename to i18n/readme/README_RU.md
diff --git a/README_TG.md b/i18n/readme/README_TG.md
similarity index 100%
rename from README_TG.md
rename to i18n/readme/README_TG.md
diff --git a/README_TH.md b/i18n/readme/README_TH.md
similarity index 100%
rename from README_TH.md
rename to i18n/readme/README_TH.md
diff --git a/README_TR.md b/i18n/readme/README_TR.md
similarity index 100%
rename from README_TR.md
rename to i18n/readme/README_TR.md
diff --git a/README_VI.md b/i18n/readme/README_VI.md
similarity index 100%
rename from README_VI.md
rename to i18n/readme/README_VI.md