Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
SpaceforgePlugin
✓ from spaceforge import SpaceforgePlugin
✗ from spaceforge import SpacePlugin
Create a simple plugin with one step and run it.
import os
from spaceforge import SpacePlugin, Step
class MyPlugin(SpacePlugin):
def steps(self):
return [Step('hello', 'echo Hello from SpaceForge')]
if __name__ == '__main__':
token = os.environ.get('SPACELIFT_API_TOKEN', '')
space = MyPlugin(token=token)
space.run()
Debug
Known issues
breakingIn version 1.5.0, the 'run' method signature changed from run(token, config) to run(config, token). Update calls accordingly.fixChange space.run(token, config) to space.run(config, token).
affects: >= 1.5.0
deprecatedThe 'Policy' class was deprecated in 1.6.0 and removed in 1.7.0. Use 'SpacePolicy' instead.fixReplace 'from spaceforge import Policy' with 'from spaceforge import SpacePolicy'.
affects: >= 1.6.0 < 1.7.0
gotchaEnvironment variables must be set before importing spaceforge, or the plugin may fail silently.fixSet SPACELIFT_API_TOKEN and other env vars before calling import spaceforge.
affects: all
Upgrade
Version history
1.7.1latest on PyPI · released May 28, 2026
Audit
Dependencies
spaceliftrequiredCore Spacelift client for API interactions