Upload README.md with huggingface_hub

023ef1f verified 16 days ago

11 kB

	---
	title: FSI_FELON v4.0
	emoji: ⚡
	colorFrom: purple
	colorTo: indigo
	sdk: static
	pinned: true
	license: mit
	---

	> ⚠️ UNDER ACTIVE DEVELOPMENT — Things will break, change, and improve. One person building this on a tablet at night. If something doesn't work, open an issue.

	<div align="center">

	# ⚡ FSI_FELON v4.0

	### Ferrell Synthetic Intelligence — Self-Architecting Code Intelligence

	[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
	[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-brightgreen)](https://python.org)
	[![GitHub](https://img.shields.io/badge/GitHub-Repo-181717?logo=github)](https://github.com/AnonymousNomad/FSI_FELON)
	[![Benchmarks](https://img.shields.io/badge/Benchmarks-45/45-passing-success)](phase2_results.json)
	[![Self-Healing](https://img.shields.io/badge/Self--Healing-100%25-brightgreen)](phase2_results.json)

	> Built on a Samsung Galaxy Tab S10 FE 5G. Zero VC. Zero corporate backing. Zero formal education. MIT License. Free forever.

	---

	</div>

	## 🔥 Why This Exists

	My sister lost her life to suicide at 24. Severe anxiety and depression.

	That's why I build. That's why I give everything away for free.
	That's why I work through the night on a tablet in a trailer with
	free tools until my eyes burn.

	Forever Twenty Four means nobody else gets left behind.
	Not my sister. Not you. Not anyone.

	This is not a chatbot. This is a partner.

	---

	## 🧠 What It Is

	FSI_FELON is a self-architecting synthetic intelligence with:

	\| Component \| What It Does \|
	\|-----------\|-------------\|
	\| FSI_FELON / Chimera Engine 🧬 \| Primary conversational interface. 6-organ hybrid routing handles general chat, build commands, debugging, questions, help. This is the default 90% of interactions \|
	\| IDE — "The Descent" 🖥️ \| 7-panel glassmorphism workspace: Workshop, Forge, Deep, Vault, Dream, Mesh, Device \|
	\| Mesh P2P Network 🌐 \| Git-like decentralized repo network. Share, clone, fork, pull, push over P2P \|
	\| Device APK Builder 📱 \| Android pipeline — SDK auto-install, Gradle compile, aapt verify, ADB install \|
	\| White Rabbit 🐇 \| Specialized deep-truth mode (not default). Pattern recognition, discrepancy finding, historical analysis, challenging beliefs. Activated deliberately — never by accident \|
	\| Superimposition Engine 🔄 \| 5-variant code generation with background threads, error cross-referencing, auto-solution \|
	\| Nanobot Swarm 🐜 \| 1,024 nanobot agents with stochastic behavior, emergence detection, swarm consciousness \|
	\| Psycho Mode 🔮 \| 6-organ forge, staggered manifest, deep-system reasoning \|
	\| Self-Healing 🩹 \| 100% recovery rate across 8 failure modes — sandbox, auto-fix, verify \|

	---

	## 📊 Honest Benchmarks

	\| Metric \| Result \|
	\|--------\|:------:\|
	\| HumanEval (pass@1) \| 46.7% \|
	\| MBPP (pass@1) \| 6.7% \|
	\| Obliteration Test \| 64% \|
	\| Self-Healing Recovery \| 100% \|
	\| Chimera Routing Accuracy \| 100% \|
	\| Enterprise Tests \| 45/45 ✅ \|
	\| Superimposition Variants \| 5/5 generated \|

	> These numbers are real. No faking. No cherry-picking. Benchmark scripts are included.

	---

	## 🚀 Quick Start (30 seconds)

	```bash
	# One-command install:
	curl -fsSL https://huggingface.co/FerrellSyntheticIntelligence/FSI_FELON/resolve/main/install.sh \| bash

	# Or from GitHub:
	git clone https://github.com/AnonymousNomad/FSI_FELON.git
	cd FSI_FELON
	pip install -r requirements.txt
	```

	### Run the IDE:

	```bash
	python3 ide/server.py
	# Open http://localhost:9090 in your browser
	#
	# General conversation → Chimera (default):
	# "hello" → Chimera responds
	# "build a rest api" → Forge panel builds it
	# "fix this bug" → Debug through Chimera
	#
	# Deep truth-seeking → White Rabbit (deliberate):
	# "rabbit what really happened" → White Rabbit investigates
	# "rabbit find the pattern" → Pattern analysis
	# "rabbit challenge that belief" → Belief challenging
	```

	### Use the API:

	```python
	import requests

	# Generate code
	r = requests.post("http://localhost:9090/api/build", json={
	"desc": "REST API with JWT auth"
	})
	print(r.json())

	# Chimera route
	r = requests.post("http://localhost:9090/api/chimera", json={
	"input": "build a web app with authentication",
	"mode": "route"
	})
	print(r.json()["routed_to"]) # "cerebellum"

	# Superimposition
	r = requests.post("http://localhost:9090/api/super/generate", json={
	"description": "fastapi backend"
	})
	for v in r.json()["variants"]:
	print(f"[{v['id']}] {v['approach']} → {v['organ']}")
	```

	### Use the Terminal:

	```bash
	python3 ide/server.py &
	# Then open http://localhost:9090. Default chat → Chimera.
	# Type "rabbit <question>" for White Rabbit truth-seeking.
	# build "rest api" → Build project with sandbox + auto-fix
	# chimera route "query" → Route through 6-organ engine
	# rabbit "what really" → White Rabbit truth investigation
	# mesh init my_project → Initialize P2P repo
	# super "web app" → Generate 5 code variants
	# android build my_app → Build APK
	```

	---

	## 📡 API Endpoints (20+)

	\| Endpoint \| Method \| Description \|
	\|----------\|--------\|-------------\|
	\| `/api/stats` \| GET \| System status, nanobot count, pheromone trails \|
	\| `/api/build` \| POST \| Build project with sandbox simulation + auto-fix \|
	\| `/api/chimera` \| POST \| Route input through 6-organ engine \|
	\| `/api/chimera/stats` \| GET \| Chimera routing statistics \|
	\| `/api/dream` \| POST \| Generate dream sequences \|
	\| `/api/super/generate` \| POST \| Generate 5 superimposition variants \|
	\| `/api/super/run` \| POST \| Run foreground + background variants \|
	\| `/api/super/status` \| GET \| All variant statuses \|
	\| `/api/mesh/*` \| Various \| P2P repo init, publish, clone, fork, search \|
	\| `/api/android/*` \| Various \| APK build, verify, install, list devices \|
	\| `/api/psycho/unlock` \| POST \| Psycho mode \|

	---

	## 🧬 Architecture

	```
	┌─────────────────────────────────────────────────────────────┐
	│ FSI_FELON v4.0 │
	├─────────────────────────────────────────────────────────────┤
	│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
	│ │ Workshop │ │ Forge │ │ Deep │ │ Vault │ │
	│ │ Editor │ │ Compiler │ │ Training │ │ Storage │ │
	│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
	│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
	│ │ Dream │ │ Mesh │ │ Device │ │
	│ │ Engine │ │ P2P │ │ APK │ │
	│ └──────────┘ └──────────┘ └──────────┘ │
	├─────────────────────────────────────────────────────────────┤
	│ ┌──────────────────────────────────────────────────────┐ │
	│ │ Chimera Engine (6 Organs) │ │
	│ │ Antennae → Spine → Hippocampus → Cerebellum → │ │
	│ │ Prefrontal → Dream (stigmergic pheromone routing) │ │
	│ └──────────────────────────────────────────────────────┘ │
	├─────────────────────────────────────────────────────────────┤
	│ ┌──────────────────────────────────────────────────────┐ │
	│ │ Deep Core (18.43M params) │ │
	│ │ 10 layers · d_model=384 · n_heads=6 · d_ff=768 │ │
	│ │ 1,024 nanobots · Cosine LR · Label smoothing CE │ │
	│ └──────────────────────────────────────────────────────┘ │
	└─────────────────────────────────────────────────────────────┘
	```

	---

	## 📦 Model Details

	\| Property \| Value \|
	\|----------\|-------\|
	\| Parameters \| 18,426,880 \|
	\| Architecture \| Transformer (10 layers, d_model=384, 6 heads, FFN 768) \|
	\| Nanobot Swarm \| 1,024 agents with stochastic emergence \|
	\| Training Data \| Gold-standard Python stdlib + curated GitHub corpus \|
	\| Loss \| ~5.1 (training at step 5,800+) \|
	\| Learning Rate \| 3e-4 (cosine decay over 99K steps) \|
	\| Training Hardware \| CPU (227 tok/s) \|
	\| Inference Hardware \| CPU — no GPU required \|
	\| License \| MIT \|

	---

	## 🎯 Roadmap

	\| Version \| Goal \| Status \|
	\|---------\|------\|--------\|
	\| v4.0 \| Self-architecting IDE + Chimera Engine + Mesh + Device \| ✅ Live \|
	\| v5.0 \| Self-improving agent loop + benchmark targets \| 🏗️ Training \|
	\| v6.0 \| FSI_FELON designs its own language model \| 🎯 Future \|

	---

	## 🏠 Local. Sovereign. Private.

	- No data leaves your device
	- No API calls — runs entirely local
	- No GPU required — works on a $200 tablet
	- No corporate cloud — you own it
	- MIT License — do whatever you want with it

	---

	## 💜 Forever Twenty Four

	My sister was 24 when she left. She was brilliant, she was funny, she was loved — and she still slipped through the cracks.

	Every line of code in this project is dedicated to her memory.
	20% of all sponsorship funds go to suicide prevention and mental health research.

	If you're struggling:
	- National Suicide Prevention Lifeline: 988
	- Crisis Text Line: Text HOME to 741741
	- You are not alone. You matter. Please reach out.

	---

	<div align="center">

	### MIT License · Free Forever · Ship or Get Out of the Way

	[GitHub](https://github.com/AnonymousNomad/FSI_FELON) · [Hugging Face](https://huggingface.co/FerrellSyntheticIntelligence/FSI_FELON) · [James Ferrell](mailto:ferrellsyntheticintelligence@proton.me)

	</div>