Skip to content

Universal Python socket for local LLMs. Zero dependencies

License

Notifications You must be signed in to change notification settings

KapitalSP/BASIC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

## πŸ“œ License

Distributed under the **MIT License**. See `LICENSE` for more information.

> **"Free to use, Free to modify. Just keep the credit."**

BASIC: The Tera-Scale Sovereign
"Stop Renting Intelligence. Own It."

BASIC is the industrial-grade, zero-latency spinal cord for 1,000B+ parameter AI.
We stripped away the safety rails, the bloat, and the cloud dependencies to give you Absolute Knowledge Sovereignty.

The Specs (No Compromise)
BASIC is not a chatbot wrapper. It is a Raw, Unbuffered Pipe between your silicon and the neural weights.

Component	Specification
Capacity	1,000B+ Ready (Distributed / Multi-GPU / NUMA-Aware)
Latency	Zero-Latency (Direct Pipe I/O. No Python Buffering.)
Architecture	Trust Gridβ„’ (Decoupled Architect & Controller)
Factory ModeSelf-Replication (Manufactures portable executables.)

The Trust Grid (Architecture)
BASIC enforces a strict industrial directory structure to ensure scalability.

BASIC/
β”œβ”€β”€ setup.py            # [The Architect] Provisions the grid & fetches the engine.
β”œβ”€β”€ basic.py            # [The Controller] Hyper-Tuner & Factory Dashboard.
β”œβ”€β”€ config.json         # [The Registry] Persistent hardware settings.
β”‚
β”œβ”€β”€ core/               # [The Brain] Inference logic & Memory sharding.
β”œβ”€β”€ drivers/            # [The Muscle] Auto-managed binaries. Don't touch.
β”œβ”€β”€ models/             # [The Soul] Drop your heavy .gguf monoliths here.
└── dist/               # [The Output] Where new agents are born.

Ignition Sequence
1. Construct (The Architect)
Build the infrastructure and summon the core engine.

python setup.py

Result: The Grid is constructed, llama-cli is downloaded, and scaffolding is deployed.

2. Mount (The Soul)
Place your .gguf model in the /models directory.
(Warning: For 100B+ models, ensure your VRAM is ready for the weight.)

3. Ignite (The Controller)
Sever the connection to the cloud. Start the engine.

python basic.py

The Hyper-Tuner Dashboard
When you run basic.py, you enter the Industrial Control Center.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ πŸŽ›οΈ  BASIC v2.2 // FACTORY EDITION                β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ [1] CPU Threads   : 8 (Performance Mode)         β”‚
β”‚ [2] GPU Layers    : 99 (Max Offload)             β”‚
β”‚ [3] Context Size  : 8192 (Large Context)         β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ [A] Auto-Optimize (Hardware Scan)                β”‚
β”‚ [B] BUILD STANDALONE (Factory Mode)              β”‚
β”‚ [S] START ENGINE (Ignition)                      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

[A] Auto-Optimize: Scans your hardware (Server/PC/Mobile) and applies the optimal thermodynamics.

[B] Factory Mode: Triggers the Self-Replication Protocol. It manufactures a portable, single-file version of this chassis into /dist.

[S] Ignition: Saves the configuration and ignites the neural engine.

Liability & Ethics
We provide the engine. You steer the car.

Zero Liability: The architect is not responsible for what you build, destroy, or replicate with this tool.

The Code: Do not cross the line. With great power comes the absolute responsibility to wield it wisely.

BASIC v2.2 // Architected by KapitalSP