runware
The Python Runware SDK is used to interact with the Runware API, powered by the Runware inference platform. It supports image generation, video generation, image upscale, video upscale, image caption, video caption, image background removal, video background removal, audio generation, and more. It also allows the use of an existing gallery of models or selecting any model or LoRA from the CivitAI gallery. The API also supports inpainting, outpainting, and a series of other ControlNet models.
Decision gist · record as of 2026-08-14
Yes, if you need a straightforward async client for the Runware API and are comfortable with an Alpha-stage library. Install friction is low, maintenance is active, and there are no known vulnerabilities. Be aware that the maintainers recommend the newer runware-python SDK for new projects, so this package is best suited for existing integrations or when you specifically need this API surface. Requires a Runware account and API key to be useful.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires RUNWARE_API_KEY environment variable or explicit API key; Runware account with API credentials and trial credits needed to call the service.
- Low install friction with a pure-Python wheel and four lightweight async dependencies (aiofiles, httpx, python-dotenv, websockets).
- Active maintenance with a recent release 45 days ago; repository shows ongoing commits and is not archived.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects without legal friction.
last release 2026-06-30 (45 days) · last repo commit 2026-06-30 · 22 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,577,057 downloads/mo, #2,995 on PyPI
Alternatives
Verify before relying
pip install runware
from runware import Runware, IImageInference
async def main():
runware = Runware(api_key="your_key")
await runware.connect()
request = IImageInference(positivePrompt="sunset", model="civitai:36520@76907", height=512, width=512)
images = await runware.imageInference(requestImage=request)
for img in images:
print(img.imageURL)- Whether the package is actively receiving new features or only bug fixes during the transition to runware-python.
- Specific rate limits or quota constraints for the Runware API when using this SDK.
- Whether all inference operations (video, audio, caption) are fully functional or partially deprecated.
What it is and what it does
Runware is an async Python client for the Runware inference platform, a hosted service for AI-powered image and media operations. It wraps REST and WebSocket transports to the Runware API, letting you generate images from text or images, upscale, remove backgrounds, and apply ControlNet models—all without running inference locally. The library depends on aiofiles, httpx, python-dotenv, and websockets to handle async I/O and environment configuration.
The package is in active maintenance but marked as Alpha; the maintainers have published a newer official SDK (runware-python) that covers the full feature surface going forward. This library remains supported during the transition, so it is stable enough for production use but may not receive all new features. You interact with it by instantiating a Runware client, connecting to the API, and calling methods like imageInference() with request objects that specify prompts, models, and generation parameters.
Use it for
- Generate images from text prompts using Stable Diffusion or other models from the CivitAI gallery.
- Upscale images or videos without local GPU resources by delegating to Runware's hosted inference.
- Remove backgrounds from images or videos as part of a batch processing pipeline.
- Apply ControlNet models or LoRA fine-tunes to customize image generation behavior.
- Integrate asynchronous image generation into web services via webhooks for long-running tasks.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a straightforward async client for the Runware API and are comfortable with an Alpha-stage library.
Install friction is low, maintenance is active, and there are no known vulnerabilities. Be aware that the maintainers recommend the newer runware-python SDK for new projects, so this package is best suited for existing integrations or when you specifically need this API surface. Requires a Runware account and API key to be useful.
Install
runware on PyPI
Before you install
Low install friction with a pure-Python wheel and four lightweight async dependencies (aiofiles, httpx, python-dotenv, websockets). Active maintenance with a recent release 45 days ago; repository shows ongoing commits and is not archived.
Requires RUNWARE_API_KEY environment variable or explicit API key; Runware account with API credentials and trial credits needed to call the service.
License in practice
MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects without legal friction.
Quickstart
pip install runware
from runware import Runware, IImageInference
async def main():
runware = Runware(api_key="your_key")
await runware.connect()
request = IImageInference(positivePrompt="sunset", model="civitai:36520@76907", height=512, width=512)
images = await runware.imageInference(requestImage=request)
for img in images:
print(img.imageURL)Verify before relying
- Whether the package is actively receiving new features or only bug fixes during the transition to runware-python.
- Specific rate limits or quota constraints for the Runware API when using this SDK.
- Whether all inference operations (video, audio, caption) are fully functional or partially deprecated.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesaiofileshttpxpython-dotenvwebsockets |
| Maintenance | Actively maintained 45 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,577,057 / month, #2,995 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 3 - AlphaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12 |
Evidence: runware-0.5.24-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “runware api client”
- runwareClient library for the Runware inference API, enabling image…
- codewords-clientA Python client library for the Codewords API with built-in FastAPI…
- twentyc.rpcA client library for consuming 20c's RESTful API, built on top of the…
Give your agent the search over MCP, or paste the wish link into any chat.
More Artificial Intelligence packages
LiteLLM provides a unified Python interface to call 100+ LLM providers (OpenAI, Anthropic, Gemini, Bedrock, Azure, and others) using OpenAI-compatible API format, available as both a Python SDK and a self-hosted AI Gateway proxy server.
Install it if you need to work with multiple LLM providers or want to centralize LLM routing in your organization.
Client library and CLI tool for downloading, uploading, and managing models, datasets, and repositories on the Hugging Face Hub platform.
Install it if you work with Hugging Face Hub models or datasets.
LangChain provides a framework for building agents and LLM-powered applications by composing language models, tools, and memory through a unified API that abstracts over multiple model providers.
hf-xet provides chunk-based deduplication and efficient file transfer for the Hugging Face Hub, enabling faster uploads and downloads of large files with local disk caching.
Tokenizers converts raw text into token sequences for NLP models, with support for training custom vocabularies and using pre-built tokenizers (BPE, WordPiece) optimized for speed via Rust.
Transformers provides a unified framework for loading, fine-tuning, and running state-of-the-art pretrained models across text, vision, audio, video, and multimodal tasks using PyTorch, JAX, or TensorFlow.
Install it if you need to run or train any transformer-based model for NLP, vision, audio, or multimodal tasks.
See also inference-sdk · vercel-cache · azure-ai-inference · realesrgan · aiodataloader · valohai-utils · anthropic · clarifai-protocol