runware

library0.5.10pypypi✓ verified 84d ago

The Python Runware SDK provides a high-level interface to the Runware API for image and video generation, upscaling, captioning, background removal, and audio generation. It supports models from Runware's gallery and CivitAI, with ControlNet, inpainting, and outpainting. Current version: 0.5.10, requires Python >=3.10. Active development with regular releases.

ai-ml

pip install runware

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · RUNWARE

runware

ai-mlpythonv0.5.10

harness data pending

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.

Runware

✓ from runware import Runware

Connect to the Runware API, generate an image, and print the result.

import asyncio from runware import Runware async def main(): runware = Runware(api_key=os.environ.get('RUNWARE_API_KEY', '')) await runware.connect() result = await runware.image_generation( model="runware:100@1", positive_prompt="a beautiful landscape", number_of_images=1, height=512, width=512, ) print(result) await runware.disconnect() if __name__ == "__main__": asyncio.run(main())

Debug

Known issues

gotchaThe SDK requires asyncio and Python >=3.10. All API calls are async; forgetting to await or not running inside an event loop will cause runtime errors.

fix

Always use async/await and run the script with asyncio.run() or inside an async context.

affects: all

gotchaThe connect() method must be called before any API calls, and disconnect() after. Failing to do so may leave connections open or cause unexpected behavior.

fix

Always call await runware.connect() before operations and await runware.disconnect() when done.

affects: all

deprecatedOlder versions used a different initialization pattern (e.g., Runware(api_key=...). In 0.5.x, the constructor only accepts api_key as a keyword argument. Passing it positionally may break.

fix

Use Runware(api_key='your_key').

affects: >=0.5.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'runware'

The package is not installed or installed in the wrong environment.

fix

Run 'pip install runware' in the correct Python environment (Python >=3.10).

TypeError: object NoneType can't be used in 'await' expression

Forgetting to call connect() before an API call, or calling a sync method that is actually async.

fix

Ensure you call 'await runware.connect()' at the start of your async function and await all API calls.

runware.exceptions.RunwareError: Invalid API key

Missing or incorrect API key provided to the Runware constructor.

fix

Set the RUNWARE_API_KEY environment variable or pass a valid key to Runware(api_key='...').

Upgrade

Version history

0.5.10latest on PyPI · released Apr 30, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/runware/sdk-python ↗

packagehttps://pypi.org/project/runware/ ↗

homepagehttps://runware.com ↗

docshttps://docs.runware.ai/ ↗

changeloghttps://github.com/runware/sdk-python/releases ↗