---
id: nflx-genie-client
version: "3.6.19"
license: Apache 2.0
license_treatment: permissive
maintenance: aging
---

# nflx-genie-client — Genie Python Client.

License: permissive · Maintenance: aging · Downloads: 185.6K/mo

## What it is and what it does

The nflx-genie-client is a Python wrapper around Netflix's Genie distributed job execution service API. It provides object models for Genie resources and a client wrapper that handles HTTP communication with retry logic based on configurable policies. The package lets you programmatically register applications and clusters, submit jobs for execution, and monitor job status through a Python interface rather than direct REST calls.

The library wraps API calls with automatic retry behavior, allowing you to specify retry counts, HTTP codes to skip, and whether to return None on 404 responses. It's built on standard dependencies including requests and python-dateutil, and is straightforward to integrate into Python applications that need to orchestrate work on Genie clusters.

Use it for:

- Submit queries to a Genie cluster and retrieve results programmatically from a Python application.
- Register and manage applications, clusters, and commands with a Genie service as part of infrastructure setup.
- Build job submission pipelines that automatically retry on transient failures without manual error handling.
- Query job status and retrieve execution information from Genie-managed jobs within a Python workflow.
- Integrate job submission into data processing scripts or ETL frameworks that run on distributed clusters.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for interacting with Netflix Genie, a distributed job execution service, providing resource models, API wrappers, and retry logic for submitting and managing jobs.

Yes, if you are actively using a Genie service and need a Python client. The package is stable, has no known vulnerabilities, and low install friction. However, maintenance is aging (last release 528 days ago), so verify that it remains compatible with your Genie instance version and modern Python environments before committing to a new project.

## Install

pip install nflx-genie-client
uv add nflx-genie-client
poetry add nflx-genie-client

## Installing nflx-genie-client

Before you install: Low install friction with a pure-Python wheel and stable dependencies. Maintenance is aging—last release was 528 days ago—but the package is marked Production/Stable and carries no known vulnerabilities.

License in practice: Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install nflx-genie-client

import genie2.client.wrapper
import genie2.model.Application

genie = genie2.client.wrapper.Genie2(
    "http://localhost:7001/genie",
    genie2.client.wrapper.RetryPolicy(tries=8, none_on_404=True)
)
app = genie2.model.Application.Application()
app.name = "exampleApp"
app.user = "user"
app.version = "0.0.1"
app.status = "ACTIVE"
created_app = genie.createApplication(app)

Requires a running Genie service instance accessible at the configured endpoint.

Verify before relying:

- Current compatibility with Python 3.11+ and modern versions of runtime dependencies
- Whether the package is actively maintained or if the 528-day gap represents end-of-life for this client version
- Compatibility with current Genie service API versions

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 185.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

genie job submission client, netflix genie python api, distributed job execution, hadoop cluster management, presto query submission, job orchestration client, genie service wrapper, job-orchestration, netflix-genie

[View on SkillFed](https://skillfed.io/packages/nflx-genie-client) · [View on PyPI](https://pypi.org/project/nflx-genie-client/)