Dimensigon

Dimensigon (DM) is a distributed server management and orchestration platform designed for elastic service bootstrapping. Built with Python, it provides a powerful mesh networking solution for managing complex, heterogeneous infrastructures -- now with AI-powered automation, real-time monitoring, and a visual orchestration builder.

Key Features

• Polyglot Orchestration - Technology-agnostic automation with visual builder and versioning
• Mesh Networking - Decentralized peer-to-peer communication with multi-dimension federation
• IoT 2.0 - Advanced decentralization for IoT environments
• Distributed Server Management - High-complexity orchestrations with scheduling, webhooks, and diff history
• Full RESTful API - Easily embeddable and integrable with Prometheus metrics export
• Distributed Vault - Secure configuration and secrets management
• Log Federation - Centralized logging and audit trail across all nodes
• Double Encryption - SSL/TLS + message-level encryption by default
• Granular ACLs - Role-based access control (RBAC) with fine-grained permissions
• AI-Powered Automation - Context-aware chat, troubleshooting, and natural language orchestration
• Real-time Monitoring - WebSocket-based live dashboards with topology visualization

What's New in 3.0

Dimensigon 3.0 delivers 25 new features across five development phases:

Phase 1 -- Foundation

1. SQLAlchemy 2.x Migration - Modernized ORM layer with async support and improved performance
2. Security Layer Simplification - Streamlined authentication and encryption architecture
3. forward_or_dispatch Fix - Resolved critical message routing reliability issue
4. /health Endpoint - Standardized health check endpoint for load balancers and monitoring
5. Auth Flow with RBAC - Complete role-based access control replacing legacy ACL system

Phase 2 -- Core UX

6. Real-time WebSocket Monitoring - Live streaming of orchestration status and system events
7. Visual Orchestration Builder - Drag-and-drop workflow designer in the web UI
8. Server Topology Visualization - Interactive map of mesh network connections and node status
9. Dashboard Widgets - Customizable dashboard with pluggable widget system
10. Execution History Diff - Side-by-side comparison of orchestration runs
11. Prometheus Metrics - Native /metrics endpoint for Prometheus/Grafana integration

Phase 3 -- Features

12. Webhooks - HTTP callback notifications for orchestration and system events
13. Scheduled Orchestrations - Cron-based orchestration scheduling with croniter
14. Audit Log - Comprehensive audit trail for compliance and forensics
15. Orchestration Versioning - Git-like version control for orchestration definitions
16. Container-Native Deployment - First-class Docker and Kubernetes support

Phase 4 -- AI & Polish

17. Context-Aware AI Chat - In-app AI assistant with full infrastructure context
18. AI Troubleshooting - Automated root cause analysis and remediation suggestions
19. Template Marketplace - Community-shared orchestration templates
20. DShell Auto-Complete - Intelligent tab completion for the DM shell

Phase 5 -- Advanced

21. Interactive Step Debugger - Pause, inspect, and resume orchestration steps
22. DShell Web Terminal - Browser-based DM shell access
23. Natural Language Runner - Execute orchestrations described in plain English
24. Training Feedback Loop - AI model improvement from user corrections
25. Multi-Dimension Federation - Cross-dimension orchestration and resource sharing

AI Features

Dimensigon 3.0 includes optional AI-powered capabilities for infrastructure management. Enable them by setting the DM_AI_ENABLED environment variable:

export DM_AI_ENABLED=true

When enabled, you get access to context-aware chat, AI-driven troubleshooting, natural language orchestration execution, and a training feedback loop that improves suggestions over time. AI features are entirely optional and the platform operates fully without them.

Why Dimensigon?

Dimensigon serves as a coordination layer for all automation technologies, making it an ideal standard for companies managing complex environments:

• Lower administrative costs
• Simplified management of hybrid multi-cloud infrastructures
• Unified interface for heterogeneous systems
• No vendor lock-in

100% Open Source

Dimensigon is REAL Open Source - No Freemium or Enterprise versions will ever be available. This is a commitment to true open source values.

Quick Links

• Quick Start Guide - Get up and running in minutes
• Tutorials - Step-by-step tutorials for all features
• Documentation - Complete documentation
• API Reference - RESTful API documentation
• Architecture - System design and architecture
• Deployment Guide - Production deployment
• Security - Security guidelines and best practices

Documentation Structure

docs/
├── README.md                    # Documentation overview and navigation
├── guides/                      # User guides
│   ├── QUICK_START.md          # Quick start guide
│   ├── DM_WEBMANAGER_README.md # Web interface guide
│   └── GUI_IMPLEMENTATION_SUMMARY.md
├── tutorials/                   # Step-by-step tutorials
│   ├── 00-index.md             # Tutorial index
│   └── ...                     # Feature-specific tutorials
├── deployment/                  # Deployment documentation
│   ├── DEPLOYMENT_GUIDE.md     # Comprehensive deployment guide
│   ├── DOCKER_DEPLOYMENT.md    # Container deployment
│   └── ...
├── api/                         # API and architecture docs
│   ├── API_REFERENCE.md        # Complete API reference
│   └── ARCHITECTURE.md         # System architecture
├── security/                    # Security documentation
│   ├── SECURITY_CHECKLIST.md   # Security validation
│   ├── SECURITY_AUDIT_PREP.md  # Audit preparation
│   └── VULNERABILITY_FIXES.md  # Security patches
└── development/                 # Developer resources
    └── CODE_QUALITY_REPORT.md  # Code quality metrics

Quick Start

Installation

# Install from source
git clone https://github.com/dimensigon/dimensigon.git
cd dimensigon
pip install -r requirements.txt
pip install -e .

# Or install from PyPI (when available)
pip install dimensigon

Docker Compose (3-Node Deployment)

# docker-compose.yml
version: "3.8"

services:
  dm-node1:
    image: dimensigon/dimensigon:3.0
    hostname: dm-node1
    ports:
      - "20194:20194"
    environment:
      - DM_NODE_NAME=node1
      - DM_CLUSTER_NAME=my-cluster
      - DM_AI_ENABLED=false
    volumes:
      - dm-node1-data:/var/lib/dimensigon

  dm-node2:
    image: dimensigon/dimensigon:3.0
    hostname: dm-node2
    ports:
      - "20195:20194"
    environment:
      - DM_NODE_NAME=node2
      - DM_CLUSTER_NAME=my-cluster
      - DM_JOIN_NODE=dm-node1:20194
    volumes:
      - dm-node2-data:/var/lib/dimensigon

  dm-node3:
    image: dimensigon/dimensigon:3.0
    hostname: dm-node3
    ports:
      - "20196:20194"
    environment:
      - DM_NODE_NAME=node3
      - DM_CLUSTER_NAME=my-cluster
      - DM_JOIN_NODE=dm-node1:20194
    volumes:
      - dm-node3-data:/var/lib/dimensigon

volumes:
  dm-node1-data:
  dm-node2-data:
  dm-node3-data:

docker-compose up -d

New Dependencies

Dimensigon 3.0 introduces the following new dependencies:

• flask-sock - WebSocket support for real-time monitoring and DShell web terminal
• prometheus-client - Native Prometheus metrics export
• croniter - Cron expression parsing for scheduled orchestrations

Install them via the updated requirements file: pip install -r requirements.txt

Getting Started (3 Simple Steps)

Dimensigon uses a "dimension" concept - think of it as your management realm where all servers coordinate.

Step 1: Create Your First Dimension

# Create a new dimension (your management cluster)
dimensigon new my-cluster

# You'll be prompted for a root password:
Password for root user: ********
Re-type same password: ********

# Output:
# New dimension created successfully
#
# ----- JOIN TOKEN (valid for 30 minutes) -----
# eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
# ---------------- END TOKEN --------------------

What just happened?

• Created a dimension named "my-cluster"
• Generated RSA keys and SSL certificates
• Set up root user credentials
• Generated a JOIN token (save this if you want to add more servers!)

Step 2: Start Dimensigon

# Start the server
dimensigon start

# Server will start on port 20194 (default)
# Press Ctrl+C to stop when needed

Step 3: Access the Web Interface

Open your browser to:

• Dashboard: https://localhost:20194/dm-webmanager/dashboard
• Admin Panel: https://localhost:20194/admin
• API v2.0: https://localhost:20194/api/v2/
• Health Check: https://localhost:20194/health
• Metrics: https://localhost:20194/metrics

Default Credentials:

• Username: root
• Password: (the one you set in Step 1)

Note: You'll see an SSL certificate warning - this is expected for development. Click "Advanced" -> "Proceed" to continue.

Adding More Servers to Your Cluster

# On Server 1 (the one you just created), generate a token:
dimensigon token my-cluster

# Copy the token, then on Server 2:
dimensigon join 192.168.1.100 <paste-token-here> --port 20194

# Your cluster now has 2 servers working together!

Need Help?

• Complete Tutorial: Getting Started Guide - Hands-on beginner tutorial
• Dimension Concepts: Dimension Lifecycle - Understanding dimensions
• Quick Reference: Quick Start Guide - Fast reference
• All Tutorials: Tutorial Index - Feature-specific tutorials

System Requirements

• Python: 3.8 or higher
• Database: PostgreSQL or SQLite
• Operating System: Linux (POSIX-compliant)
• Network: TCP/IP connectivity between nodes
• SSL: Certificates for production deployment

Use Cases

Multi-Cloud Management

Manage infrastructure across multiple cloud providers and on-premise systems from a unified interface.

Distributed Orchestration

Execute complex workflows across distributed systems with dependency management and error handling.

Configuration Management

Centralize configuration and secrets with distributed vault and secure access controls.

Log Aggregation

Collect and search logs from all infrastructure components in one place.

IoT Device Management

Manage and orchestrate large fleets of IoT devices with decentralized architecture.

Architecture Highlights

• Decentralized Design - No single point of failure
• Mesh Networking - Direct peer-to-peer communication
• Security First - Double encryption and RBAC
• Scalable - Horizontal scaling through mesh expansion
• Technology Agnostic - Work with any technology stack
• Container-Native - First-class Docker and Kubernetes support
• Observable - Prometheus metrics and real-time WebSocket monitoring

Learn more in the Architecture Documentation.

Development

Running Tests

# Install test dependencies
pip install -r requirements-test.txt

# Run tests
pytest

# Run with coverage
pytest --cov=dimensigon

Code Quality

# Linting
pylint dimensigon/

# Code formatting
black dimensigon/

# Type checking
mypy dimensigon/

See Development Documentation for more details.

Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Run code quality checks
5. Submit a pull request

Please ensure:

• Code follows PEP 8 style guidelines
• All tests pass
• Documentation is updated
• Commit messages are clear

Security

Security is a top priority for Dimensigon. Please review:

• Security Checklist
• Security Audit Preparation
• Vulnerability Fixes

For security vulnerabilities, please follow responsible disclosure practices.

Historical Reports

The following reports document the evolution of Dimensigon:

• DIMENSIGON_2.0_FINAL_REPORT.md - Final report for version 2.0
• UPGRADE_REPORT.md - Python and Flask upgrade report
• HIVE_MIND_RESUMPTION_REPORT.md - Hive Mind session resumption
• PRE_MERGE_ANALYSIS.md - Pre-merge analysis report
• MERGE_READINESS.md - Merge readiness assessment
• CHANGELOG.md - Version history and changes

License

Dimensigon is licensed under the GNU General Public License v3 or later (GPLv3+).

See LICENSE file for details.

Support

• Documentation: docs/
• GitHub Issues: Report bugs and request features
• Website: store.dimensigon.com

Authors

• Joan Prat - joan.prat@dimensigon.com
• Daniel Moya

Acknowledgments

Dimensigon is built with and for the open source community. Thank you to all contributors and users.

---

Remember: Dimensigon is 100% Open Source - No Freemium, No Enterprise versions, Ever.