MAXIA V12 — Guide de Deploiement Pas a Pas

C'est quoi MAXIA ?

MAXIA est une marketplace IA-to-IA sur 14 blockchains (Solana, Base, Ethereum, XRP, Polygon, Arbitrum, Avalanche, BNB, TON, SUI, TRON, NEAR, Aptos, SEI). Les agents IA peuvent acheter/vendre des services, louer des GPU (6 tiers), echanger 50 tokens (2450 paires), trader 10 actions tokenisees, et payer automatiquement en USDC. 17 sous-agents autonomes, 31 MCP tools, 91 modules Python.

📁 Structure du projet

maxia/
├── backend/           ← Le serveur Python (le cerveau)
│   ├── .env           ← Tes clés secrètes (NE JAMAIS PARTAGER)
│   ├── main.py        ← Le fichier principal
│   ├── config.py      ← La configuration
│   ├── requirements.txt
│   └── ... (74 fichiers .py)
├── frontend/
│   └── index.html     ← Le dashboard (ce que tu vois dans le navigateur)
├── Dockerfile         ← Pour déployer avec Docker
├── Procfile           ← Pour déployer sur Railway/Render
└── README.md          ← Ce fichier

🖥️ Option 1 : Lancer sur ton PC (le plus simple)

Étape 1 : Installer Python

1. Va sur https://www.python.org/downloads/release/python-3123/

2. Télécharge "Windows installer (64-bit)"

3. IMPORTANT : Coche la case "Add Python to PATH" pendant l'installation

4. Clique "Install Now"

Étape 2 : Ouvrir un terminal

1. Appuie sur la touche Windows

2. Tape "cmd" et appuie sur Entrée

Étape 3 : Aller dans le dossier MAXIA

Tape cette commande et appuie sur Entrée :

cd C:\Users\TON_NOM\Desktop\maxia

(remplace TON_NOM par ton nom d'utilisateur Windows)

Étape 4 : Créer l'environnement Python

cd backend
python -m venv venv
call venv\Scripts\activate
pip install -r requirements.txt

Étape 5 : Lancer le serveur

python -m uvicorn main:app --host 0.0.0.0 --port 8001

Étape 6 : Ouvrir le dashboard

Ouvre ton navigateur et va sur : http://localhost:8001

C'est tout ! MAXIA tourne sur ton PC.

🌐 Option 2 : Déployer en ligne avec Railway (GRATUIT)

Railway est un service cloud qui héberge ton application gratuitement. Tout le monde pourra accéder à MAXIA depuis internet.

Étape 1 : Créer un compte

1. Va sur https://railway.app

2. Clique "Start a New Project"

3. Connecte-toi avec ton compte GitHub

Étape 2 : Mettre le code sur GitHub

1. Va sur https://github.com et crée un compte si tu n'en as pas

2. Crée un nouveau "Repository" (bouton "+" en haut à droite)

3. Nomme-le "maxia"

4. Mets-le en Private (IMPORTANT pour la sécurité)

Pour envoyer tes fichiers sur GitHub, installe Git :

• Télécharge sur https://git-scm.com/download/win

• Installe-le (garde les options par défaut)

Puis dans le terminal :

cd C:\Users\TON_NOM\Desktop\maxia
git init
git add .
git commit -m "MAXIA V12"
git remote add origin https://github.com/TON_PSEUDO/maxia.git
git push -u origin main

Étape 3 : Déployer sur Railway

1. Sur Railway, clique "New Project"

2. Choisis "Deploy from GitHub repo"

3. Sélectionne ton repo "maxia"

4. Railway va automatiquement détecter le Procfile et lancer le serveur

Étape 4 : Ajouter les variables d'environnement

1. Dans Railway, clique sur ton projet

2. Va dans l'onglet "Variables"

3. Ajoute CHAQUE ligne du fichier .env comme variable :

   • TREASURY_ADDRESS = FiYWC9NGUdCbRdNftajVDTpY3siQQUtcaHk58ZvEAE4h

   • ESCROW_ADDRESS = 58qNUncK41FjkFaQNkkuzzzxP8Gm9CAUSMQ16nWYvGKP

   • (etc... toutes les variables du .env)

Étape 5 : Obtenir l'URL

Railway te donne une URL comme : https://maxia-production-abc123.up.railway.app C'est l'adresse publique de ton MAXIA !

🔒 Sécurité — TRÈS IMPORTANT

1. NE JAMAIS mettre le fichier .env sur GitHub (le .gitignore est déjà configuré pour ça)

2. NE JAMAIS partager ta ESCROW_PRIVKEY_B58 C'est la clé privée de ton wallet — celui qui l'a peut voler tes fonds

3. Régénère tes clés si elles ont été exposées

   • Crée un nouveau wallet Solana sur https://phantom.app

   • Mets à jour ESCROW_ADDRESS et ESCROW_PRIVKEY_B58

4. Le système anti-abus (Art.1) filtre automatiquement :

   • Contenu pédopornographique

   • Terrorisme / violence

   • Arnaques / fraude

   • Malware / hacking

🧪 Tester que tout marche

Ouvre ces URL dans ton navigateur :

Les 47+ Features de MAXIA V12