"Forge your sovereign path through the cosmos"
SKSkyforge is a comprehensive daily preparation system that generates personalized sovereign alignment calendars. It integrates 10 domains of guidance into a unified system for optimal daily performance.
| Domain | Description |
|---|---|
| 🌓 Moon Phase & Sign | Lunar phase, zodiac position, void-of-course periods |
| 🔢 Numerology | Life path, personal year/month/day calculations |
| 🌞 Solar Return | Annual chart, house focus, planetary transits |
| 🧬 Human Design | Type, strategy, authority, daily gate activations |
| ☯️ I Ching | Daily hexagram overlay with wisdom guidance |
| 📈 Biorhythm | Physical, emotional, intellectual cycle tracking |
| Multi-domain risk scoring and warnings | |
| 🧘 Exercise & Embodiment | Physical activity recommendations |
| 🥣 Nourishment | Element-based dietary guidance |
| 📖 Spiritual Reading | Daily wisdom texts from curated library |
- Year-Agnostic: Generate calendars for any year (2025, 2026, 2027, etc.)
- Multi-User Profiles: Support multiple users with saved birth data
- Multiple Output Formats: PDF, Excel/CSV, JSON, Web Dashboard
- Actionable Guidance: Daily practices for optimal performance
# Clone the repository
git clone https://github.com/smilinTux/SKyForge.git
cd SKyForge
# Create virtual environment
python -m venv venv
source venv/bin/activate # Linux/Mac
# or: venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Install in development mode
pip install -e .# Interactive profile creation
skskyforge profile create
# Or with all options
skskyforge profile create \
--name "my_profile" \
--birth-date "1985-03-15" \
--birth-time "14:30" \
--birth-location "New York, NY, USA"# Generate full year calendar
skskyforge generate --year 2026
# Generate single month
skskyforge generate --year 2026 --month 1
# Generate with specific format
skskyforge generate --year 2026 --format pdf
# Preview a single day
skskyforge preview --date 2026-01-15- Python 3.10 or later
- Swiss Ephemeris data files (downloaded automatically)
skskyforge/
├── agent.md # AI agent instructions
├── prd.txt # Product requirements
├── requirements.txt # Python dependencies
├── pyproject.toml # Project configuration
├── config/
│ ├── settings.yaml # Global settings
│ └── profiles/ # User profiles
├── src/skskyforge/
│ ├── cli.py # Command-line interface
│ ├── models/ # Data models
│ ├── calculators/ # Domain calculators
│ ├── analyzers/ # Risk & wellness analyzers
│ ├── generators/ # Output generators
│ └── data/ # Reference data
└── tests/ # Test suite
- CLI Quickstart - Get started in 5 minutes
- agent.md - Technical specifications for developers
- prd.txt - Product requirements document
Copy .env.example to .env and configure:
cp .env.example .envKey settings:
SKSKYFORGE_OUTPUT_DIR- Output directory for generated filesSKSKYFORGE_DEFAULT_PROFILE- Default profile nameSWISSEPH_PATH- Swiss Ephemeris data path
Edit config/settings.yaml to customize:
- Output format preferences
- Calculation parameters
- Wellness recommendation rules
- Spiritual library rotation
# Run all tests
pytest
# Run with coverage
pytest --cov=skskyforge
# Run specific test file
pytest tests/test_calculators/test_numerology.py# Format code
black src/ tests/
# Lint code
ruff src/ tests/
# Type checking
mypy src/╔══════════════════════════════════════════════════════════════════╗
║ SKSKYFORGE DAILY SOVEREIGN ALIGNMENT ║
║ Wednesday, January 15, 2026 (Day 15 of 365) ║
╠══════════════════════════════════════════════════════════════════╣
║ DAILY THEME: "Grounded Action with Emotional Wisdom" ║
║ OVERALL ENERGY: Moderate-High | RISK LEVEL: Low ║
╚══════════════════════════════════════════════════════════════════╝
🌙 MOON: Waxing Gibbous (78%) in Taurus
🔢 NUMEROLOGY: Personal Day 5 (Universal Day 7)
☀️ SOLAR TRANSIT: Sun in Capricorn, 10th House Focus
🧬 HUMAN DESIGN: Gate 41 (Decrease) Active
☯️ I CHING: Hexagram 41 - Decrease
📊 BIORHYTHM: Physical +67% | Emotional +23% | Mental -12%
⚠️ RISK ANALYSIS: Low (Score: 22/100)
💫 TODAY'S AFFIRMATION:
"I build my dreams with patient, steady hands."
Contributions are welcome! Please read the contributing guidelines before submitting pull requests.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 smilinTux
SK = staycuriousANDkeepsmilin 🐧
See LICENSE for the full license text.
- Swiss Ephemeris for astronomical calculations
- The I Ching and Human Design communities
- All wisdom traditions represented in the spiritual library
SKSkyforge - Scientifically mapped. Spiritually grounded.