Skip to main content

Flux RESTFul API

All Contributors

DOI PyPI Version

https://github.com/flux-framework/flux-restful-api/raw/main/img/flux-restful-eyes-small.png

This is a small Flux Python API (using FastAPI) that can be containerized alongside Flux, and provide an easy means to interact with Flux via the API. With Flux RESTful we can:

  1. provide simple endpoints to submit jobs, list jobs, or get job status
  2. eventually support subscribing to events and a user interface job table
  3. option to kill or stop the server (intended for Flux Operator)
  4. allow for start with a user name and token (for basic auth)

Install the server with pip install flux-restful (the Flux Python bindings come with Flux itself) and start it under a Flux instance with flux start flux-restful serve.

This project is new and we look forward to hearing your feedback. See our ⭐️ Documentation ⭐️ to get started, and take a look at the clients we provide to interact with the server.

https://github.com/flux-framework/flux-restful-api/raw/main/img/flux-restful.png

😁️ Contributors 😁️

We use the all-contributors tool to generate a contributors graphic below.

Vanessasaurus
Vanessasaurus

💻
Todd Gamblin
Todd Gamblin

💻
Khoi Nguyen
Khoi Nguyen

💻
dupgit
dupgit

💻

Project interaction is governed by a Code of Conduct. Please see our Code of Conduct for contributing.

LICENSE

DevTools is distributed under the terms of the MIT license. All new contributions must be made under this license.

See LICENSE, COPYRIGHT, and NOTICE for details.

SPDX-License-Identifier: (MIT)

LLNL-CODE- 842614

Metadata

Release files for flux-restful 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flux-restful 1.1.0
File Size Uploaded
flux_restful-1.1.0.tar.gz 80.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for flux-restful 1.1.0
File Interpreter ABI Platform
flux_restful-1.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 168.1 kB

Release files / flux_restful-1.1.0.tar.gz

Download URL flux_restful-1.1.0.tar.gz
Size 80.6 kB
Tags Source
SHA-256 checksum
How to use checksums
48ca1941cf09ab17e7a2208e93089ad900273235162c231f44fba0e3e52648c4
BLAKE2b-256 checksum
How to use checksums
8677992736f9521c9eb070ae5984fb4993eeb3f803f84f0f0f10baafe704f67e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Release files / flux_restful-1.1.0-py3-none-any.whl

Download URL flux_restful-1.1.0-py3-none-any.whl
Size 87.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1cd1c70c106a4116b6c7a7398acd87d88bbe9f7fa2b1dee62929ca1b5b4b4455
BLAKE2b-256 checksum
How to use checksums
f379bf124d2032f7994a39317c6f10b89a7d7201859693334d9140bfcbaee89f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page