---
id: spaceforge
version: "1.8.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# spaceforge — A Python framework for building Spacelift plugins

License: permissive · Maintenance: active · Downloads: 103.6K/mo

## What it is and what it does

Spaceforge is a Python framework designed to simplify building plugins for Spacelift, a cloud-native infrastructure automation platform. Instead of manually writing plugin manifests, you define your plugin logic in Python using a declarative, hook-based approach, and Spaceforge automatically generates the required manifest configuration. The framework depends on PyYAML for configuration parsing, click for CLI support, pydantic for data validation, Jinja2 for template rendering, and mergedeep for configuration merging.

The package targets infrastructure and DevOps teams who want to extend Spacelift's capabilities without wrestling with manifest syntax. It's currently in Alpha status, having been released in August 2025, and supports Python 3.10 and later. The project is actively maintained with recent commits, though it remains relatively new and has not yet accumulated significant community adoption or a large user base.

Use it for:

- Build custom Spacelift plugins for infrastructure automation workflows without manually authoring manifest files
- Define plugin hooks and logic in Python to extend Spacelift's native capabilities for your organization
- Generate Spacelift plugin manifests declaratively from Python code to reduce configuration boilerplate
- Integrate custom DevOps logic into Spacelift pipelines using a structured, type-validated framework

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Spaceforge is a Python framework for building Spacelift plugins using a declarative, hook-based approach that automatically generates plugin manifests.

Yes, with conditions. Install if you are actively building Spacelift plugins and prefer Python-first development over manifest authoring. The low install friction, permissive license, and active maintenance make it a reasonable choice. However, the Alpha status and limited real-world adoption mean you should verify that the framework's hook types and capabilities match your plugin requirements before committing to it in production.

## Install

pip install spaceforge
uv add spaceforge
poetry add spaceforge

## Installing spaceforge

Before you install: Low install friction with a pure-Python wheel and five common dependencies (PyYAML, click, pydantic, Jinja2, mergedeep). The package is actively maintained with a recent commit history, though it remains in Alpha status and has been available for less than a year.

License in practice: MIT license is permissive and imposes no significant restrictions on use, modification, or redistribution in most contexts.

Quickstart:

pip install spaceforge

from spaceforge import Plugin

plugin = Plugin(name="my-plugin")
# Define hooks and logic declaratively

Requires Python 3.10 or later.

Verify before relying:

- Specific hook types and plugin capabilities available in the framework
- Whether the framework handles Spacelift API integration or only manifest generation
- Community adoption and real-world plugin examples beyond documentation

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 103.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

spacelift plugin framework, python spacelift plugins, declarative plugin development, infrastructure as code plugins, spacelift devops automation, plugin manifest generation, hook-based plugin system, spacelift-plugins, infrastructure-automation, devops-framework

[View on SkillFed](https://skillfed.io/packages/spaceforge) · [View on PyPI](https://pypi.org/project/spaceforge/)