Download README.org from Snapkitty/nekomata: direct link, hf CLI and curl.
- Browser
- Download file 3.11 kB
-
https://huggingface.co/Snapkitty/nekomata/resolve/main/README.org
- Command line
-
hf download hf://Snapkitty/nekomata/README.org
-
curl -L -o README.org https://huggingface.co/Snapkitty/nekomata/resolve/main/README.org
3.11 kB
| #+TITLE: Nekomata η«ε | |
| #+SUBTITLE: Infrastructure that rewrites itself. | |
| #+AUTHOR: Ahmad Ali Parr Γ SnapKitty Collective | |
| #+LICENSE: AGPL-3.0 | |
| * What is Nekomata? | |
| Nekomata is the first AI-native container engine built from first principles. | |
| Not a Kubernetes alternative. A Kubernetes replacement. | |
| The Nekomata (η«ε) is a supernatural cat with two tails: code and data. | |
| In Common Lisp, these are the same thing. Infrastructure is code. | |
| Code is alive. It evaluates. It transforms. It rewrites itself. | |
| * Why not Kubernetes? | |
| Kubernetes was designed in 2014, before LLMs, before sparse MoEs, | |
| before we understood that code should be data. It is a YAML configuration | |
| engine running on a distributed key-value store. It is 50B of technical | |
| debt masquerading as infrastructure. | |
| * First Principles | |
| | Kubernetes Assumption | Nekomata First Principle | | |
| |------------------------------+---------------------------------------| | |
| | Infrastructure is YAML | Infrastructure is s-expressions | | |
| | Monolithic control plane | Sparse mixture of experts | | |
| | Immutable containers | Live REPL injection | | |
| | Reactive watch loops | Predictive LLMβASM compilation | | |
| | Networking is afterthought | Regex mathematics at socket layer | | |
| * Quick Start | |
| #+BEGIN_SRC lisp | |
| (ql:quickload :nekod) | |
| (nekod:nekomata-main) | |
| #+END_SRC | |
| * Container DSL | |
| Infrastructure expressed as s-expressions. A container is a Lisp form. | |
| It evaluates. It transforms. It rewrites itself. | |
| #+BEGIN_SRC lisp | |
| (nekod:define-container my-app | |
| :image "nginx:latest" | |
| :ports '((8080 . 80)) | |
| :env '((:NODE_ENV . "production")) | |
| :restart-policy :always) | |
| #+END_SRC | |
| * Self-Healing with Failover Chains | |
| #+BEGIN_SRC lisp | |
| (nekod:with-failover my-app my-app-replica my-app-standby) | |
| #+END_SRC | |
| * Repo Layout | |
| #+BEGIN_EXAMPLE | |
| nekod/ | |
| βββ nekod.asd β ASDF system definition | |
| βββ core/ | |
| β βββ package.lisp β Package definitions | |
| β βββ conditions.lisp β Error hierarchy + restarts | |
| β βββ sexpr-infra.lisp β Container DSL macros + JSON serialization | |
| β βββ eval-loop.lisp β Nekomata REPL | |
| β βββ image-persist.lispβ State snapshot save/restore | |
| β βββ nekomata.lisp β Top-level entry point + registry | |
| βββ docker/ | |
| βββ unix-sock.lisp β Raw Unix socket interface | |
| βββ protocol.lisp β HTTP/1.1-over-Unix encoder/decoder | |
| βββ container.lisp β Container lifecycle (create/start/stop/kill/list) | |
| βββ image.lisp β Image management (pull/list/tag/prune) | |
| βββ network.lisp β Network management (create/connect/disconnect) | |
| βββ volume.lisp β Volume management (create/mount/prune) | |
| βββ inspect.lisp β Container and stats inspection | |
| #+END_EXAMPLE | |
| * License | |
| AGPL-3.0 β Free to use, modify, and distribute. | |
| Cloud providers who SaaS-ify this must contribute back. | |
| This is the poison pill. | |