AI228 Hub est une plateforme open source qui recense les meilleures intelligences artificielles (IA) utilisées par les Togolais au quotidien. Chaque utilisateur peut partager ses outils IA préférés par catégorie, expliquer comment il les utilise, et découvrir de nouvelles IA adaptées à ses besoins.

---

🌟 À propos

AI228 Hub (Artificial Intelligence 228) est un projet communautaire togolais visant à :

• Mettre en avant les IA utiles et accessibles pour les créateurs, développeurs et entrepreneurs.
• Encourager le partage d’expériences locales autour de l’intelligence artificielle.
• Créer un répertoire national open source d’outils IA selon leur usage.

Le “228” fait référence à l’indicatif téléphonique du Togo 🇹🇬 — symbole d’un projet créé par et pour les Togolais.

---

🚀 Fonctionnalités

• 🧩 Catalogue d’IA : Découvrez les outils IA les plus utilisés par la communauté.
• 🗂️ Classement par catégories : Code, Contenu, Vidéo, Images, Audio, Éducation, Debugage, etc.
• ✍️ Explication personnelle d’usage : Chaque contributeur explique, avec ses propres mots, comment il utilise une IA.
• 🔍 Recherche & Filtrage : Trouvez rapidement les IA selon vos besoins.
• 📱 Responsive Design : Interface adaptée à tous les écrans.
• 🌐 Interface en français.
• 🔐 Connexion GitHub (optionnelle) : Pour afficher vos contributions et profil.
• 🤝 Open Source & Hacktoberfest : Contributions ouvertes à tous !

---

🛠️ Technologies utilisées

• Next.js 15 — Framework React moderne
• TypeScript — Typage robuste
• Tailwind CSS — Design rapide et élégant
• Framer Motion — Animations fluides
• NextAuth.js v5 — Authentification GitHub
• JSON (ou Prisma) — Gestion simple des données
• GitHub API (optionnel) — Statistiques contributeurs

---

⚙️ Installation et démarrage

🧩 Prérequis

• Node.js 18+
• npm, yarn, pnpm ou bun

🚀 Étapes

1. Cloner le repository

   git clone https://github.com/Donchaminade/ai228-hub.git
   cd ai228-hub

2. Installer les dépendances

   npm install
   # ou
   yarn install

3. Lancer le serveur

   npm run dev

4. Accéder à l’application

   http://localhost:3000

---

🤝 Comment contribuer

Nous accueillons toutes les contributions, que ce soit du code, de la documentation ou simplement l’ajout d’une IA !

🔧 1. Fork et clone

git clone https://github.com/Donchaminade/ai228-hub.git

🌿 2. Crée une branche

git checkout -b feature/ajout-nouvelle-ia

✍️ 3. Modifie le fichier data/ai.json

Ajoute ton IA avec cette structure :

{
  "id": 3,
  "name": "Nom de l'IA",
  "description": "Brève description de ce que fait cette IA.",
  "link": "https://lien-de-l-ia.com/",
  "category": "Contenu",
  "author": "Ton nom ou pseudo",
  "date_added": "YYYY-MM-DD",
  "utilisation": "Explique comment tu utilises cette IA dans ton quotidien, avec tes propres mots."
}

🚀 4. Envoie ta contribution

git commit -m "Ajout: [Nom de l'IA]"
git push origin feature/ajout-nouvelle-ia

Puis crée une Pull Request.

---

🧱 Structure du projet

ai228-hub/
├── app/                   # Pages Next.js
│   ├── layout.tsx
│   ├── page.tsx
│   ├── categories/        # Pages par catégorie
│   └── add-ai/            # Formulaire d’ajout
├── components/
│   ├── Navbar.tsx
│   ├── AICard.tsx
│   └── CategoryFilter.tsx
├── data/
│   └── ai.json            # Liste des IA recensées
├── public/
│   ├── logo.svg
│   └── icons/
├── README.md
└── LICENSE

---

🧠 Exemple de données (data/ai.json)

[
  {
    "id": 1,
    "name": "ChatGPT",
    "description": "Assistant IA développé par OpenAI, utile pour le code, le contenu et le brainstorming.",
    "link": "https://chat.openai.com/",
    "category": "Contenu",
    "author": "Docteur-Parfait",
    "date_added": "2025-10-27",
    "utilisation": "Je l’utilise pour générer des idées de textes, corriger mes écrits et trouver des solutions de code rapidement."
  },
  {
    "id": 2,
    "name": "Midjourney",
    "description": "Outil de génération d’images artistiques à partir de texte.",
    "link": "https://midjourney.com/",
    "category": "Images",
    "author": "Chaminade",
    "date_added": "2025-10-27",
    "utilisation": "Je décris une scène en français simple, et Midjourney me génère des visuels magnifiques pour mes designs et présentations."
  }
]

---

🎯 Objectifs communautaires

• 🔍 Mettre en avant les IA les plus utiles pour les Togolais
• 💬 Encourager le partage d’expériences locales
• 🤝 Promouvoir la collaboration open source
• 🎓 Inspirer la formation et l’éducation à l’IA

---

🏷️ Hacktoberfest 2025

Ce projet participe au Hacktoberfest 2025 🎃 Les contributions avec les labels suivants sont encouragées :

• hacktoberfest
• good first issue
• help wanted

---

📝 Licence

Ce projet est sous licence MIT. Consultez le fichier LICENSE pour plus de détails.

---

👥 Auteurs

• Chaminade Dondah Adjolou – Créateur du projet – @Donchaminade

---

🙏 Remerciements

• La communauté tech du Togo 🇹🇬
• Les participants du Hacktoberfest
• Tous les passionnés d’IA et d’open source

---

Fait avec ❤️ par @Donchaminade — AI228 Hub 🇹🇬