Skip to main content

Welcome to Ensemble

Ensemble is a platform for building, versioning, and deploying software components with Git-native workflows. Start with Edgit for component management, and expand to Conductor for advanced orchestration.

Choose Your Product

Start with Edgit for component management, then expand to Conductor for orchestration.

What You’ll Learn

Each quick start guide walks you through:
  1. Installation - Set up the CLI and dependencies
  2. Initialization - Configure your project
  3. First Component - Add and manage your first component
  4. Versioning - Create and deploy version tags
  5. Next Steps - Explore advanced features

Prerequisites

All Ensemble products require:
  • Node.js version 18 or higher
  • Git version 2.30 or higher
  • A Git repository (local or remote)
Already using Git? Edgit integrates seamlessly with your existing workflow. No migration needed.

Product Comparison

FeatureEdgitConductor
Component Registry✅ Full support✅ Via Edgit
Git Tag Versioning✅ Native support✅ Uses Edgit tags
AI Commit Messages✅ Built-inN/A
Agent Orchestration❌ Not available✅ Core feature
Workflow Automation❌ Not available✅ Core feature

Key Features

Use native Git tags for semantic versioning. No more version bumps in package.json or separate version files.
edgit tag email-agent v1.2.0
git push origin v1.2.0
Automatically generate conventional commit messages based on component changes.
edgit commit  # AI analyzes diffs and generates message
Track all components in .edgit/components.json with metadata, dependencies, and configuration.
{
  "functions": {
    "email-agent": {
      "type": "function",
      "path": "src/agents/email.ts",
      "description": "Email processing agent"
    }
  }
}
Track which versions are deployed to which environments.
edgit deploy email-agent v1.2.0 --to production
edgit status email-agent  # Shows deployment history

Choose Your Path

1

Start with Edgit

Perfect for teams managing components, functions, or agents in Git repositories.Continue to Edgit Quick Start →
2

Add Conductor (Optional)

When you need to orchestrate complex workflows across multiple components.Learn about Conductor →
3

Explore Cloud (Optional)

Managed service for visual editing, versioning, and A/B testing.Learn about Cloud →