Skip to content

Getting Started with SysGit#

Welcome to SysGit, the Model-Based Systems Engineering platform that brings hardware development into your existing Git workflow. This guide will help you understand the platform and get started with your first project.

What SysGit Offers#

SysGit enables systems engineers to create, iterate, review, and share requirements and system models using the same tools and practices that revolutionized software development. The platform provides three primary capabilities:

Requirements Management: Capture, decompose, and analyze requirements in one integrated platform that keeps every stakeholder aligned with the mission and ensures consistency across every project phase. Work with requirements through Table, Graph, and Code views that stay perfectly synchronized.

System Modeling and MBSE: Use proven version control tools to capture full system architectures and iterate with confidence as your design evolves. Create part breakdown structures, diagram interconnections, and model state machines using SysML v2 Textual Notation—an open standard that ensures long-term data portability.

Systems Engineering Automation: Improve models continuously with CI/CD integration and DevOps workflows. Accelerate development and reduce errors with automated checks, validation pipelines, and programmatic access through the SysGit Python library.

Understanding the Platform#

SysGit takes a fundamentally different approach from traditional MBSE tools. Rather than creating another walled garden with proprietary data formats, SysGit stores all engineering data as SysML v2 text files in your existing Git repositories. This "Post-Cloud" architecture means your team maintains complete control over data while inheriting the security posture and access controls you've already implemented in your Git provider.

The platform offers flexible deployment options. IT-supported deployment delivers SysGit through a centralized server with browser-based access, while self-service deployment provides a desktop application that individual users install and configure with their own API credentials. Both approaches store all data in your Git infrastructure—the deployment choice only affects how users access the interface.

For a deeper understanding of how this architecture works and why it matters for enterprise systems engineering, see Understanding Post-Cloud Architecture.

Installation Options#

Choose the deployment model that matches your organization's needs:

IT-Supported Deployment: Your IT team deploys SysGit as centralized services that users access through a web browser. This approach provides consistent experience across all users and is currently the only option for AI/ML capabilities. Requires IT involvement to deploy and maintain.

Self-Service Deployment: Individual users download and install the SysGit desktop application on their own workstations. Users generate personal access tokens from your Git provider to connect. This approach eliminates IT deployment requirements but users must manage their own updates.

Detailed installation procedures for both deployment models are provided in Installation and Setup.

What's Next#

After installing and configuring SysGit, you'll be ready to start working with requirements and system models. The platform supports three synchronized interface views—Table, Graph, and Code—that provide different perspectives on the same underlying SysML v2 model. Changes made in any view automatically appear in the others, allowing you to work in whichever interface matches your current task.

Start exploring SysGit's capabilities:

  • Requirements Management: Learn how to create, organize, and trace requirements through their lifecycle
  • System Modeling: Understand how to build system architectures with parts, ports, and connections
  • Verification Management: Discover how to link requirements to verification activities and manage test coverage
  • Apply branching and merging strategies for collaborative hardware development

The documentation provides practical examples throughout using unmanned aircraft systems (UAS/drone) components to illustrate real-world modeling patterns. These examples demonstrate how SysGit's capabilities apply to complex hardware systems typical in aerospace and defense applications.