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.

• Polyglot Orchestration - Technology-agnostic automation and orchestration
• Mesh Networking - Decentralized peer-to-peer communication
• IoT 2.0 - Advanced decentralization for IoT environments
• Distributed Server Management - High-complexity orchestrations across infrastructure
• Full RESTful API - Easily embeddable and integrable
• Distributed Vault - Secure configuration and secrets management
• Log Federation - Centralized logging across all nodes
• Double Encryption - SSL/TLS + message-level encryption by default
• Granular ACLs - Fine-grained access control on top of OS security

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

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

• Quick Start Guide - Get up and running in minutes
• Documentation - Complete documentation
• API Reference - RESTful API documentation
• Architecture - System design and architecture
• Deployment Guide - Production deployment
• Security - Security guidelines and best practices

docs/
├── README.md                    # Documentation overview and navigation
├── guides/                      # User guides and tutorials
│   ├── QUICK_START.md          # Quick start guide
│   ├── DM_WEBMANAGER_README.md # Web interface guide
│   └── GUI_IMPLEMENTATION_SUMMARY.md
├── 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

# 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

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

# 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!)

# Start the server
dimensigon start

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

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/

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.

# 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!

• Complete Tutorial: Getting Started Guide - Hands-on beginner tutorial
• Dimension Concepts: Dimension Lifecycle - Understanding dimensions
• Quick Reference: Quick Start Guide - Fast reference

• 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

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

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

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

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

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

• Decentralized Design - No single point of failure
• Mesh Networking - Direct peer-to-peer communication
• Security First - Double encryption and ACLs
• Scalable - Horizontal scaling through mesh expansion
• Technology Agnostic - Work with any technology stack

Learn more in the Architecture Documentation.

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

# Run tests
pytest

# Run with coverage
pytest --cov=dimensigon

# Linting
pylint dimensigon/

# Code formatting
black dimensigon/

# Type checking
mypy dimensigon/

See Development Documentation for more details.

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 is a top priority for Dimensigon. Please review:

• Security Checklist
• Security Audit Preparation
• Vulnerability Fixes

For security vulnerabilities, please follow responsible disclosure practices.

The following reports document the evolution of Dimensigon 2.0:

• 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

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

See LICENSE file for details.

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

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

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.