|
Download README.md from gregrsea/HumpBack: direct link, hf CLI and curl.
- Browser
- Download file 3.05 kB
-
https://huggingface.co/gregrsea/HumpBack/resolve/main/README.md
- Command line
-
hf download hf://gregrsea/HumpBack/README.md
-
curl -L -o README.md https://huggingface.co/gregrsea/HumpBack/resolve/main/README.md
3.05 kB
| language: en | |
| license: mit | |
| tags: | |
| - neural-network | |
| - evolutionary | |
| - metacognition | |
| - tool-use | |
| - 3-vector-weights | |
| pipeline_tag: text-generation | |
| # HumpBack: 3-Vector Neural Model (Python) | |
| **A small, from-scratch neural architecture.** Not a wrapper around a pretrained model. Not an "agent" claiming self-awareness. It learns by storing facts, evolving connection weights, and calling tools when uncertain. | |
| ## What it actually is | |
| - A graph of ~30 neurons, each with three weight vectors: **concept**, **spatial**, **temporal** (128 dimensions each). | |
| - Hebbian plasticity + gradient-free genetic evolution optimize the graph. | |
| - Associative memory stores facts via hashed text → vector retrieval. | |
| - Metacognition assesses confidence; uncertainty triggers web search or code execution tools. | |
| - All training data lives in `humpback/corpus.py` — no hidden internet training. | |
| ## What it can do | |
| - Answer factual queries about its corpus (~98% recall after 5 epochs). | |
| - Call tools: `calculator`, `read_file`, `list_dir`, `run_code`, `write_file`, plus optional web search. | |
| - Generate code (fibonacci, sort, etc.) and run it through `run_code`. | |
| - Create simple websites by writing HTML/CSS to disk via `write_file`. | |
| - Persist/save/load full network state (`model.json`) and pack weights into `weights.zip`. | |
| ## Truthful limitations | |
| - This is **not** a large language model. No transformers, no billion-parameter backbones. | |
| - "Metacognition" is a confidence threshold over cosine similarity scores, not consciousness. | |
| - Code generation uses pattern-matched templates from the training corpus, not deep reasoning. | |
| - Self-consciousness is not claimed or demonstrated here. The science does not support it. | |
| ## Quick start | |
| ```bash | |
| pip install -r requirements.txt | |
| python -m humpback.server --host 127.0.0.1 --port 8000 | |
| ``` | |
| Open http://127.0.0.1:8000 | |
| ## API | |
| | Endpoint | Method | Description | | |
| |---|---|---| | |
| | `/` | GET | Web UI (chat + viz) | | |
| | `/v1/chat/completions` | POST | OpenAI-compatible chat | | |
| | `/v1/models` | GET | List models | | |
| | `/train` | POST | Run one evolution step, return stats | | |
| | `/viz.png` | GET | Static network visualization | | |
| | `/viz.html` | GET | Interactive D3.js graph | | |
| ## Training | |
| ```python | |
| from humpback.agent import HumpbackModel | |
| m = HumpbackModel() | |
| m.train(epochs=5) # learns 62 facts → 98% recall | |
| m.save("model.json") | |
| m.evolution.evolve(steps=20) | |
| ``` | |
| Or from CLI: | |
| ```bash | |
| python _train.py | |
| ``` | |
| ## Tools | |
| After training, you can query the model directly: | |
| ```python | |
| result = m.think("make a website") | |
| print(result["answer"]) # generates generated_site/index.html via write_file tool | |
| result = m.think("run code fibonacci") | |
| print(result["answer"]) # executes fibonacci, prints fib(10)=55 | |
| ``` | |
| The same endpoints work over HTTP for automation. | |
| ## Architecture | |
| See `humpback/server.py` for the web harness, `humpback/corpus.py` for training data, and `humpback/tools/registry.py` for the built-in tools. `generated_site/index.html` was produced by the model itself as proof of tool calling. | |
| ## License | |
| MIT |