ε - Update README

This commit is contained in:
Eun0us 2026-01-19 11:37:27 +01:00
parent 118cac4f3b
commit a9151d4fd2
5 changed files with 56 additions and 27 deletions

1
.gitignore vendored
View File

@ -46,6 +46,7 @@ tools/c3po/config.json
*.log *.log
logs/ logs/
espilon_bot/logs/ espilon_bot/logs/
sdkconfig
# IDE and Editor # IDE and Editor
.vscode/ .vscode/

View File

@ -56,10 +56,10 @@ cd esp-idf
# 2. Clone Espilon # 2. Clone Espilon
cd ~ cd ~
git clone https://github.com/yourusername/epsilon.git git clone https://github.com/Espilon-Net/epsilon-source.git
cd epsilon/espilon_bot cd Espilon-Net/espilon_bot
# 3. Configure # 3. Configure with menuconfig or tools/flasher/devices.json
idf.py menuconfig idf.py menuconfig
# 4. Build and flash # 4. Build and flash

View File

@ -56,7 +56,7 @@ cd esp-idf
# 2. Cloner Espilon # 2. Cloner Espilon
cd ~ cd ~
git clone https://github.com/yourusername/epsilon.git git clone https://github.com/Espilon-Net/epsilon-source.git
cd epsilon/espilon_bot cd epsilon/espilon_bot
# 3. Configurer # 3. Configurer
@ -103,7 +103,7 @@ Espilon transforme des microcontrôleurs ESP32 abordables à **~5€** en agents
## Architecture ## Architecture
``` ```md
┌─────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────┐
│ ESP32 Agent │ │ ESP32 Agent │
│ ┌───────────┐ ┌──────────┐ ┌─────────────────┐ │ │ ┌───────────┐ ┌──────────┐ ┌─────────────────┐ │
@ -117,12 +117,12 @@ Espilon transforme des microcontrôleurs ESP32 abordables à **~5€** en agents
│ └───────────────────────────────────────────────┘ │ │ └───────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────┘
↕ Encrypted TCP ↕ Encrypted TCP
┌─────────────────────┐ ┌─────────────────────
│ C2 Server (C3PO) │ │ C2 Server (C3PO) │
│ - Device Registry │ │ - Device Registry │
│ - Group Management │ │ - Group Management │
│ - CLI Interface │ │ - CLI Interface │
└─────────────────────┘ └─────────────────────
``` ```
### Composants Clés ### Composants Clés
@ -130,6 +130,7 @@ Espilon transforme des microcontrôleurs ESP32 abordables à **~5€** en agents
- **Core** : Connexion réseau, crypto ChaCha20, protocole nanoPB - **Core** : Connexion réseau, crypto ChaCha20, protocole nanoPB
- **Modules** : Système extensible (Network, FakeAP, Recon, etc.) - **Modules** : Système extensible (Network, FakeAP, Recon, etc.)
- **C2 (C3PO)** : Serveur Python asyncio pour contrôle multi-agents - **C2 (C3PO)** : Serveur Python asyncio pour contrôle multi-agents
- **C3PO**: Ancien c2 (serveur web - Trilateration + Front affichage caméra)
- **Flasher** : Outil de flash multi-device automatisé - **Flasher** : Outil de flash multi-device automatisé
--- ---
@ -211,15 +212,39 @@ python3 flash.py --config devices.json
```json ```json
{ {
"project": "/path/to/espilon_bot", "project": "/home/user/epsilon/espilon_bot",
"devices": [ "devices": [
## WiFi AGENT ##
{ {
"device_id": "esp001", "device_id": "ce4f626b",
"port": "/dev/ttyUSB0", "port": "/dev/ttyUSB0",
"srv_ip": "192.168.1.13",
"srv_port": 2626,
"network_mode": "wifi", "network_mode": "wifi",
"wifi_ssid": "MyNetwork", "wifi_ssid": "MyWiFi",
"wifi_pass": "MyPassword", "wifi_pass": "MyPassword123",
"srv_ip": "192.168.1.100" "hostname": "pixel-8-pro",
"module_network": true,
"module_recon": false,
"module_fakeap": false,
"recon_camera": false,
"recon_ble_trilat": false,
"crypto_key": "testde32chars00000000000000000000",
"crypto_nonce": "noncenonceno"
},
## GPRS AGENT ##
{
"device_id": "a91dd021",
"port": "/dev/ttyUSB1",
"srv_ip": "203.0.113.10",
"srv_port": 2626,
"network_mode": "gprs",
"gprs_apn": "sl2sfr",
"hostname": "galaxy-s24-ultra",
"module_network": true,
"module_recon": false,
"module_fakeap": false
} }
] ]
} }
@ -302,7 +327,8 @@ Espilon doit être utilisé uniquement pour :
### V2.0 (En cours) ### V2.0 (En cours)
- [ ] Mesh networking (BLE/WiFi) - [ ] Mesh networking (BLE/WiFi)
- [ ] Améliorer la Documentations - [ ] Implémenter Module reccoon dans C3PO
- [ ] Améliorer la Documentations [here](https://docs.espilon.net)
- [ ] OTA updates - [ ] OTA updates
- [ ] Multilatération collaborative - [ ] Multilatération collaborative
- [ ] Optimisation mémoire - [ ] Optimisation mémoire
@ -335,7 +361,7 @@ Voir [LICENSE](LICENSE) pour les détails complets.
- **@Eun0us** - Core architecture, modules - **@Eun0us** - Core architecture, modules
- **@off-path** - C2 server, protocol - **@off-path** - C2 server, protocol
- **@itsoktocryyy** - Network features - **@itsoktocryyy** - Network features, Wall Hack
- **@wepfen** - Documentation, tools - **@wepfen** - Documentation, tools
### Contribuer ### Contribuer

View File

@ -115,7 +115,7 @@ menu "Security"
config CRYPTO_KEY config CRYPTO_KEY
string "ChaCha20 Key (32 bytes)" string "ChaCha20 Key (32 bytes)"
default "testde32chars00000000000000000000" default "testde32chars0000000000000000000"
config CRYPTO_NONCE config CRYPTO_NONCE
string "ChaCha20 Nonce (12 bytes)" string "ChaCha20 Nonce (12 bytes)"

View File

@ -42,6 +42,7 @@ The `devices.json` file contains:
{ {
"project": "/home/user/epsilon/espilon_bot", "project": "/home/user/epsilon/espilon_bot",
"devices": [ "devices": [
## WiFi AGENT ##
{ {
"device_id": "ce4f626b", "device_id": "ce4f626b",
"port": "/dev/ttyUSB0", "port": "/dev/ttyUSB0",
@ -59,6 +60,7 @@ The `devices.json` file contains:
"crypto_key": "testde32chars00000000000000000000", "crypto_key": "testde32chars00000000000000000000",
"crypto_nonce": "noncenonceno" "crypto_nonce": "noncenonceno"
}, },
## GPRS AGENT ##
{ {
"device_id": "a91dd021", "device_id": "a91dd021",
"port": "/dev/ttyUSB1", "port": "/dev/ttyUSB1",