A.B.E.L - Adam Beloucif Est Là

Assistant Personnel Intelligent - Interface Cyberpunk PWA avec Chat AI, Mémoire RAG & Proxy API Universel

Architecture

flowchart TB
    PWA["Client React 18 + Vite 6<br/>PWA - Workbox - TypeScript strict"]
    PAGES["Pages<br/>Intro HUD - Home - Chat - System - Settings"]
    STORE["État Zustand<br/>hooks/useAbelChat.ts - stores"]
    API["Backend FastAPI<br/>server/app/main.py - endpoints api/"]
    CORE["Core<br/>core/config.py - core/database.py"]
    BRAIN["Service Brain<br/>services/brain.py - orchestration LLM"]
    MEM["Service Memory<br/>services/memory.py - RAG"]
    DB["Supabase + pgvector<br/>mémoire vectorielle"]
    LLM["LangChain + OpenAI<br/>génération réponses"]

    PWA --> PAGES
    PAGES --> STORE
    STORE -->|WebSocket / HTTP| API
    API --> CORE
    API --> BRAIN
    BRAIN --> MEM
    MEM --> DB
    CORE --> DB
    BRAIN --> LLM

Loading

Features

• PWA installable (iOS, Android, Desktop)
• Animation intro HUD Cyberpunk
• Interface Command Center
• Chat AI temps réel (WebSocket)
• Mémoire RAG avec pgvector
• Proxy API Universel (+1400 APIs)
• Authentification biométrique (face-api.js)
• Intégration Deezer

Tech Stack

Layer	Technology
Frontend	React 18 + Vite 6 + TypeScript
PWA	vite-plugin-pwa + Workbox
Styling	Tailwind CSS + Framer Motion
State	Zustand
Backend	FastAPI (Python)
Database	Supabase + pgvector
LLM	LangChain + OpenAI

Installation

Prerequisites

• Node.js 20+
• Python 3.11+
• Compte Supabase (gratuit)

Frontend

cd client
npm install
npm run dev

Backend

cd server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload

Environment Variables

Copier .env.example vers .env et remplir les valeurs :

cp .env.example .env

Structure

A.B.E.L/
├── client/              # Frontend React PWA
│   ├── src/
│   │   ├── components/  # UI Components
│   │   ├── pages/       # App Pages
│   │   ├── hooks/       # Custom Hooks
│   │   └── stores/      # Zustand Stores
│   └── public/          # Static Assets
│
├── server/              # Backend FastAPI
│   ├── app/
│   │   ├── api/         # Endpoints
│   │   ├── core/        # Config & DB
│   │   └── services/    # Business Logic
│   └── scripts/         # Utilities
│
└── docs/                # Documentation

Commands

# Development
npm run dev          # Start frontend
uvicorn app.main:app --reload  # Start backend

# Build
npm run build        # Build PWA
npm run preview      # Preview build

Changelog

v1.0.0 (2025-01-20)

• Initial release
• PWA setup with vite-plugin-pwa
• Cyberpunk UI components
• Animation intro HUD
• Basic chat interface

---

Author: Adam Beloucif

---

_{Par Adam Beloucif - Data Engineer & Fullstack Developer - GitHub - LinkedIn}

Star History