📦Open Source Packages

Chicago Forest Packages

Modular npm packages for building decentralized, privacy-preserving P2P networks. Each package handles a specific aspect of mesh networking.

npm install @chicago-forest/p2p-core

Important Disclaimer: AI-Generated Theoretical Framework

This entire website and all its content is an AI-generated theoretical framework created as an exploratory exercise to envision potential pathways to net-zero energy solutions. This is NOT a real, operational network, nor are there any actual plasma forest installations.

All technical specifications, protocols, and implementations described here are speculative interpretations of historical research by Tesla, Mallove, Moray, and others. This project represents hope and vision for sustainable energy futures, not existing technology or proven solutions.

No claims of working devices or energy generation are being made. This is a conceptual exploration and should be understood as such. Any real-world implementation would require extensive scientific validation, engineering development, and regulatory approval.

Generated by AI as a theoretical exercise in sustainable energy visioning. Not investment advice or scientific fact.

Quick Install

Install all packages at once using the CLI, or pick individual packages for your needs:

Install CLI globally:

npm install -g @chicago-forest/cli

Or clone the repo:

git clone https://github.com/vespo92/ChicagoForest.net

Core

🔌

Beta

p2p-core

@chicago-forest/p2p-core

Core P2P primitives including node identity, peer discovery, and connection management

Features:

✓Ed25519 cryptographic identity
✓Kademlia DHT peer discovery
✓Connection lifecycle management

npm install @chicago-forest/p2p-core

🛤️

Beta

routing

@chicago-forest/routing

Unified routing layer integrating multiple protocols with intelligent path selection

Features:

✓Multi-protocol aggregation
✓Configurable path selection policies
✓Route metrics and monitoring

npm install @chicago-forest/routing

📝

Stable

shared-types

@chicago-forest/shared-types

TypeScript type definitions shared across all Chicago Forest packages

Features:

✓Comprehensive type coverage
✓Strict TypeScript support
✓Protocol message types

npm install @chicago-forest/shared-types

Networking

📡

Alpha

wireless-mesh

@chicago-forest/wireless-mesh

WiFi Direct, ad-hoc networking, and mesh routing protocols (BATMAN-adv, OLSR, Babel)

Features:

✓BATMAN-adv mesh routing
✓OLSR and Babel support
✓Link quality monitoring

npm install @chicago-forest/wireless-mesh

🌉

Alpha

sdwan-bridge

@chicago-forest/sdwan-bridge

SD-WAN tunnel management with WireGuard, VXLAN, and traffic engineering

Features:

✓WireGuard tunnel support
✓VXLAN overlay networks
✓Multi-path load balancing

npm install @chicago-forest/sdwan-bridge

🌐

Alpha

ipv7

@chicago-forest/ipv7

Experimental IPV7 protocol with 256-bit addresses and mesh-native routing

Features:

✓256-bit address space
✓Geohash-based routing
✓Cryptographic identity

npm install @chicago-forest/ipv7

🔄

Alpha

ipv7-adapter

@chicago-forest/ipv7-adapter

Bridge between IPV7 and traditional IPv4/IPv6 networks

Features:

✓Address translation
✓Packet encapsulation
✓IPv6 compatibility mode

npm install @chicago-forest/ipv7-adapter

Privacy

🧅

Alpha

anon-routing

@chicago-forest/anon-routing

Tor-inspired onion routing for anonymous, censorship-resistant communication

Features:

✓Multi-hop encrypted circuits
✓Hidden services support
✓Traffic padding

npm install @chicago-forest/anon-routing

Infrastructure

🛡️

Alpha

firewall

@chicago-forest/firewall

Chicago Forest Firewall engine with OPNsense integration and rule generation

Features:

✓nftables/iptables generation
✓OPNsense config export
✓Fluent rule builder DSL

npm install @chicago-forest/firewall

🔧

Alpha

hardware-hal

@chicago-forest/hardware-hal

Hardware abstraction for WiFi adapters, LoRa radios, and 60GHz backhaul

Features:

✓WiFi adapter abstraction
✓LoRa SX1262/SX1276 support
✓60GHz backhaul interface

npm install @chicago-forest/hardware-hal

🐳

Alpha

node-deploy

@chicago-forest/node-deploy

Deployment configurations for Docker, Kubernetes, and VMs with NIC passthrough

Features:

✓Docker Compose configs
✓Kubernetes manifests
✓cloud-init for VMs

npm install @chicago-forest/node-deploy

Tools

💻

Beta

cli

@chicago-forest/cli

Command-line interface for node management, deployment, and network operations

Features:

✓10+ CLI commands
✓Node initialization
✓Peer management

npm install -g @chicago-forest/cli

Package Architecture

┌─────────────────────────────────────────────────────────────┐
│                     @chicago-forest/cli                      │
│              (Command-line interface for all operations)     │
└─────────────────────────────────────────────────────────────┘
                              │
    ┌─────────────────────────┼─────────────────────────┐
    │                         │                         │
    ▼                         ▼                         ▼
┌─────────────┐       ┌─────────────┐       ┌─────────────────┐
│   routing   │       │  wireless-  │       │  anon-routing   │
│  (unified)  │◄─────►│    mesh     │       │   (privacy)     │
└─────────────┘       └─────────────┘       └─────────────────┘
    │                         │                         │
    └─────────────────────────┼─────────────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │    p2p-core     │
                    │ (peer discovery │
                    │   & identity)   │
                    └─────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │  shared-types   │
                    │  (TypeScript)   │
                    └─────────────────┘

Ready to Build?

Start with our getting started guide or dive into the source code on GitHub.

Get Started Guide View on GitHub