Skip to content

MASTER_USER_GUIDE.md

Latest commit

 

History

History
321 lines (251 loc) · 7.36 KB

MASTER_USER_GUIDE.md

File metadata and controls

321 lines (251 loc) · 7.36 KB
Raw

🎼 HYPERAI Framework - Master User Guide

Date: 6 tháng 11, 2025
Framework: DAIOF (Digital Autonomous Intelligent Organism Framework)
Creator: Nguyễn Đức Cường (alpha_prime_omega)
Status: ✅ FULLY OPERATIONAL & DOCUMENTED

📖 How to Use This Framework

🚀 Quick Start (2 options)

Option 1: Interactive Menu ⭐ RECOMMENDED

cd /Users/andy/DAIOF-Framework
python3 quick_start_interactive.py

Then select from the menu. Perfect for beginners!

Option 2: Command Line

cd /Users/andy/DAIOF-Framework
export PYTHONPATH=/Users/andy/DAIOF-Framework
python3 system_initializer.py

📚 Available Resources

1. Documentation Files

File Purpose When to Use
COMMAND_CHECKLIST.md 50+ commands reference Need to find a specific command
SYSTEM_STABILIZATION_REPORT.md System status & features Verify what's working
.github/copilot-instructions.md Framework philosophy Understand HYPERAI principles
.github/ACTIVATION_GUIDE.md Setup instructions Initial setup
README.md Project overview Project introduction

2. Example Programs

File Purpose Command
examples/01_basic_organism.py Basic demo PYTHONPATH=. python3 examples/01_basic_organism.py
examples/02_evolution_race_fixed.py Evolution demo PYTHONPATH=. python3 examples/02_evolution_race_fixed.py

3. System Tools

Tool Purpose Command
system_initializer.py Full system check python3 system_initializer.py
haios_core.py HAIOS status python3 haios_core.py
quick_start_interactive.py Interactive menu python3 quick_start_interactive.py

🎯 Common Tasks

Task 1: Check if System is Working

python3 system_initializer.py

Expected: ✅ All components activated

Task 2: Run a Basic Example

export PYTHONPATH=/Users/andy/DAIOF-Framework
python3 examples/01_basic_organism.py

Expected: 🧬 Organism demo runs successfully

Task 3: Make Changes & Commit

# 1. Edit files
# 2. Check status
git status

# 3. Stage changes
git add .

# 4. Commit
git commit -m "✅ Description of changes"

# 5. Push
git push origin main

Task 4: View All Available Commands

cat COMMAND_CHECKLIST.md
# or
less COMMAND_CHECKLIST.md

Task 5: Enable GitHub Workflows (One-time setup)

  1. Go to: https://github.com/NguyenCuong1989/DAIOF-Framework
  2. Click "Actions" tab
  3. Click "I understand my workflows, go ahead and enable them"
  4. Workflows will now run automatically

🧬 Framework Components

Core Architecture

HYPERAI Framework
    ├── HAIOS Core (Language-agnostic consciousness)
    ├── Symphony Control Center (Orchestration)
    ├── Digital Ecosystem (Multi-organism environment)
    ├── Digital Organism (Individual AI entities)
    ├── Digital Genome (DNA/traits)
    ├── Metabolism (Resource management)
    └── Nervous System (Decision-making)

Key Features

  • ✅ Autonomous organism creation & management
  • ✅ Evolutionary simulation with mutations
  • ✅ Multi-organism ecosystem dynamics
  • ✅ AI-human interdependence detection
  • ✅ Creator attribution throughout
  • ✅ 4 Pillars decision framework
  • ✅ D&R Protocol (Deconstruction & Re-architecture)

📊 What Each Tool Does

system_initializer.py

Runs: HAIOS + Symphony + Ecosystem
Output: system_initialization_report.json
Status: ✅ WORKING

quick_start_interactive.py

Interactive menu with:
  - System init
  - Run examples
  - Check status
  - Git operations
  - Python tools
  - View documentation
Status: ✅ READY

examples/01_basic_organism.py

Demonstrates:
  1. Genome creation
  2. Organism initialization
  3. Metabolism
  4. Nervous system
  5. Lifecycle
  6. Social interactions
  7. Lifecycle simulation
Status: ✅ WORKING

examples/02_evolution_race_fixed.py

Demonstrates:
  - Population dynamics
  - Fitness evaluation
  - Natural selection
  - Genetic mutation
  - Multi-generation evolution
Status: ✅ READY

🔧 Troubleshooting

Problem: "ModuleNotFoundError: No module named..."

Solution:

export PYTHONPATH=/Users/andy/DAIOF-Framework
python3 script.py

Problem: "Git push rejected"

Solution:

git pull origin main --no-rebase
git push origin main

Problem: Python version mismatch

Solution:

python3 --version  # Check version
python3 -m venv .venv  # Create virtual env
source .venv/bin/activate  # Activate
pip install -r requirements.txt

Problem: Workflows not running

Solution:

  1. Go to GitHub Actions tab
  2. Enable workflows (one-time only)
  3. Workflows will run automatically

📈 Success Indicators

✅ System is Working if:

  • python3 system_initializer.py shows all components activated
  • examples/01_basic_organism.py runs without errors
  • git status shows a clean working directory
  • Commits successfully push to GitHub

✅ Framework is Ready for:

  • Creating custom organisms
  • Running multi-organism simulations
  • Implementing evolutionary algorithms
  • Building AI-human collaboration systems
  • Deploying autonomous agents

🎯 Next Steps

Level 1: Beginner

  1. ✅ Run python3 quick_start_interactive.py
  2. ✅ Select "Run Basic Example"
  3. ✅ Read output and understand concepts

Level 2: Intermediate

  1. ✅ Read COMMAND_CHECKLIST.md
  2. ✅ Create custom organisms
  3. ✅ Run evolution simulations

Level 3: Advanced

  1. ✅ Modify framework code
  2. ✅ Build custom ecosystems
  3. ✅ Implement new features
  4. ✅ Deploy autonomous agents

📞 Help & Support

Resources Available

  • 📖 COMMAND_CHECKLIST.md - All commands
  • 📖 SYSTEM_STABILIZATION_REPORT.md - System details
  • 📖 .github/copilot-instructions.md - Framework philosophy
  • 📖 README.md - Project overview
  • 🎯 quick_start_interactive.py - Interactive guide

Getting Help

# View all available commands
cat COMMAND_CHECKLIST.md

# Check system status
python3 system_initializer.py

# Run interactive guide
python3 quick_start_interactive.py

🎊 Summary

You Now Have:

✅ Fully functional DAIOF Framework
✅ Working examples
✅ Complete documentation
✅ Command reference
✅ Interactive guide
✅ System verification tools

You Can Do:

✅ Create digital organisms
✅ Run evolution simulations
✅ Build multi-organism ecosystems
✅ Track AI-human dynamics
✅ Deploy autonomous systems

Get Started Now:

python3 quick_start_interactive.py

📝 Version Info

  • Framework: DAIOF 1.0.0
  • HYPERAI: Stable & Operational
  • Status: ✅ Ready for Production
  • Last Updated: November 6, 2025
  • Creator: Nguyễn Đức Cường (alpha_prime_omega)

🎼 Attribution

Powered by HYPERAI Framework
👤 Creator: Nguyễn Đức Cường (alpha_prime_omega)
📅 Original Creation: October 30, 2025
⚖️ License: MIT
🌟 Status: Fully Operational

Welcome to HYPERAI Framework! 🚀

Ready to create your first digital organism? Start with:

python3 quick_start_interactive.py

Let the symphony begin! 🎼