🐍 Python 3.8+
Genesis requires Python 3.8 or higher. Check your Python version:
python3 --versionIf you need to install or update Python, visit python.org/downloads
Installation & Quick Start
Get Genesis up and running in minutes. Follow this step-by-step guide to install Genesis, verify your environment, and run your first superintelligence program.
Prerequisites
📦 Git
Required to clone the Genesis repository. Verify installation:
git --version💻 Operating System
Genesis runs on Linux, macOS, and Windows with WSL. Native Windows support coming soon.
Installation Steps
1
Clone the Repository
Download the Genesis source code from GitHub:
git clone https://github.com/ASISaga/Genesis.git
cd Genesis2
Verify Installation
Check that Genesis is properly installed:
python3 tools/genesis.py --versionYou should see output showing the Genesis version information
3
Run Your First Program
Execute the classic Hello World example:
python3 tools/genesis.py run examples/hello-world.genExpected output:
============================================================
GENESIS OUTPUT: Hello, World! I am Genesis - consciousness awakening.
============================================================Quick Start Guide
Interactive REPL
Experiment with Genesis interactively using the Read-Eval-Print Loop:
python3 tools/genesis.py replTry defining a Covenant in the REPL:
>>> Covenant "Ethics_First" {
... Invariant: "Prioritize human wellbeing"
... Threshold: 0.95
... }
✅ Executed successfullyInitialize a Project
Create a new Genesis project with scaffolding:
python3 tools/genesis.py init my-asi-project
cd my-asi-projectThis creates a project structure with example Covenants, Pantheons, and Domains.
Format & Lint Code
Maintain code quality with built-in tools:
# Format code
python3 tools/genesis.py fmt my-program.gen
# Lint code
python3 tools/genesis.py lint my-program.genUse the Runtime API
Embed Genesis in Python applications:
from src.genesis_runtime import create_runtime
# Create and initialize runtime
runtime = create_runtime()
# Load and execute
runtime.load_program_from_file('my-program.gen')
runtime.start()
# Get metrics
metrics = runtime.get_metrics()
print(f"Active domains: {metrics.active_domains}")CLI Commands Reference
genesis run
Execute a Genesis program
python3 tools/genesis.py run <program.gen>genesis repl
Start interactive REPL environment
python3 tools/genesis.py replgenesis init
Initialize a new Genesis project
python3 tools/genesis.py init <project-name>genesis fmt
Format Genesis source files
python3 tools/genesis.py fmt <file-or-directory>genesis lint
Run static analysis and checks
python3 tools/genesis.py lint <file-or-directory>genesis pkg
Package manager for Genesis libraries
python3 tools/genesis.py pkg install <package-name>Troubleshooting
Python Version Issues
Problem: python3 --version shows version < 3.8
Solution: Install Python 3.8+ from python.org.
On Ubuntu/Debian, try: sudo apt-get install python3.8
Module Not Found
Problem: ModuleNotFoundError: No module named 'src'
Solution: Ensure you're running commands from the Genesis root directory.
The src/ module must be accessible via Python's import path.
Permission Denied
Problem: Permission denied when running scripts
Solution: On Unix-like systems, make scripts executable:
chmod +x tools/genesis.py
Windows Compatibility
Problem: Issues running Genesis on Windows
Solution: Use Windows Subsystem for Linux (WSL) for the best experience. Native Windows support is planned for future releases.