skillfed

spaceforge

A Python framework for building Spacelift plugins

spaceforge v1.8.0 103.6K downloads/30d#12,796 on PyPI0
Permissive license MIT Active released

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 on this page — 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

spaceforge on PyPI

pip

pip install spaceforge

uv

uv add spaceforge

poetry

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 the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies 5 — PyYAML, click, pydantic, Jinja2, mergedeep
Maintenance actively maintained — 43 days since the last release
Last repo commit
First released
Downloads 103,568/month — #12,796 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: spaceforge-1.8.0-py3-none-any.whl

Keywords: spacelift, plugin, framework, infrastructure, devops, spaceforge

Development Status :: 3 - AlphaIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Topic :: Software Development :: Libraries :: Python ModulesTopic :: System :: Systems Administration

Tags

spacelift plugin frameworkpython spacelift pluginsdeclarative plugin developmentinfrastructure as code pluginsspacelift devops automationplugin manifest generationhook-based plugin system
spacelift-pluginsinfrastructure-automationdevops-framework

More Python Modules packages