Turn any REST API into a standalone pyspark connector script — no runtime, just generated code.
Welcome to Polymo
Polymo turns a REST API into a standalone Lakeflow Declarative Pipelines script. Fill out the Builder UI form, preview real responses, and export — zero polymo runtime dependency, no config to load, nothing to import from polymo at all. The script only needs requests, the standard library, and pyspark.
The builder generates standalone scripts
For example, pointing the builder at https://jsonplaceholder.typicode.com/posts generates the following (elided below for brevity — the real file also includes retry/backoff and response-normalization helpers):
"""posts — generated by the polymo builder.
Standalone Lakeflow Declarative Pipelines source. polymo is NOT needed
at runtime; edit this file freely.
"""
BASE_URL = "https://jsonplaceholder.typicode.com"
PATH = "/posts"
PARAMS: dict = {"_limit": 20}
# … fetch/retry helpers elided …
@dp.table(name="posts")
def posts():
rows = list(fetch_records())
return spark.createDataFrame(rows)
See docs/superpowers/specs/2026-08-28-codegen-pivot-design.md for the full design behind this pivot.
How does it work?
Open the Builder UI, describe your API (base URL, path, pagination, auth, schema — all optional except the URL and path), and preview it against the real API. When you're happy, switch to the Generated Code tab and download the script. Every field you fill in is baked into that script as a plain Python constant or a small block of generated code — there is nothing left to configure at runtime, and no polymo import anywhere in the output.
See the Connector options reference for what every Builder field generates, and the Builder UI walkthrough for a guided tour of the form.
Migrating from polymo 0.x?
The YAML runtime (spark.read.format("polymo"), PolymoConfig,
polymo smoke) is gone in 1.0. See
docs/migration-1.0.md for what changed, and pin
polymo<1.0 (0.11.0 is the last release with the old runtime) if you're not
ready to move yet.
How to start?
Locally you probably want to install polymo along with the Builder UI:
pip install "polymo[builder]"
This comes with all UI deps such as pyspark.
Scripting connector generation directly in Python (calling generate() /
parse_config() without the UI — see the API reference)
doesn't need pyspark at all. In that case, just install the bare minimum
deps with:
pip install polymo
Note that pip install polymo alone does not install the Builder UI, and
polymo is never a dependency of the scripts it generates — nothing you
export needs polymo installed to run.
Launch the builder UI
polymo builder
(Optional) Run the Builder in Docker
docker compose up --build builder
- The service listens on port
8000; open http://localhost:8000 once Uvicorn reports it is running.
Where to Next
Read the docs here
Other material:
- Step by step example: medium blogpost (written for the 0.x YAML runtime — see the migration guide for what changed)
Contributing
It's still early days, but Polymo already supports a lot of features! Is there something missing? Raise an issue or contribute!
Contributions and early feedback welcome!
If Polymo helped, a ⭐ makes my day
1 maintainer
Metadata
1 maintainer
Release files for polymo 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| polymo-1.0.0.tar.gz | 179.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| polymo-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 368.6 kB
Release files / polymo-1.0.0.tar.gz
| Download URL | polymo-1.0.0.tar.gz |
|---|---|
| Size | 179.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d7659c0c6ad9424b229a2f994be8bbc9b2a2373e9ee91f5b0cf5575abb1e2b92
|
|
BLAKE2b-256 checksum How to use checksums |
2ec776aea8e758b69e332a53d3252607b2ff24b4a9daed6986cd304bd1b4df73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.
Transparency logRelease files / polymo-1.0.0-py3-none-any.whl
| Download URL | polymo-1.0.0-py3-none-any.whl |
|---|---|
| Size | 189.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8082a989dbb7e68cfb0c67690a8d0c161dba763774eb5d93cb5bce597f75d19
|
|
BLAKE2b-256 checksum How to use checksums |
00b7998c8c2de6882fef8a7fb928c356dfda47c7c34985500d3e9c28e21d1270
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.
Transparency log
