FlowClient

1.34.0 verified Sat May 09 auth: no python

A Python client library for interacting with the FlowMachine API, providing access to aggregated network data analysis queries. Current version 1.34.0, released on 2025-05-09. Requires Python >=3.6. Released approximately every 2-3 months.

pip install flowclient

Common errors

error ModuleNotFoundError: No module named 'flowclient' ↓

cause Library not installed in current environment.

fix

pip install flowclient

error AttributeError: module 'flowclient' has no attribute 'FlowClient' ↓

cause Importing FlowClient from top-level instead of submodule.

fix

from flowclient.client import FlowClient

error requests.exceptions.ConnectionError ↓

cause Wrong URL scheme or server not reachable.

fix

Check URL includes http:// or https:// and server is running.

Warnings

gotcha Token authentication is required, but the token is not validated on client instantiation. Errors will only appear when making the first query. ↓

fix Always test connectivity with a simple query like get_available_dates() after creating the client.

gotcha The parameter 'url' in FlowClient must include the scheme (http:// or https://). Omitting it causes obscure connection errors. ↓

fix Always provide a full URL, e.g., 'http://localhost:9090'.

gotcha Some query functions return an 'id' (a query ID) instead of results. You must use run_async() or similar to execute synchronous queries. ↓

fix For synchronous behaviour, use client.run_query(query_id) after constructing the query or use the function's sync variant if available.

Imports

FlowClient
wrong
```
from flowclient import FlowClient
```
correct
```
from flowclient.client import FlowClient
```
FlowClient is in the client submodule; top-level import works but is less explicit.

get_available_dates

from flowclient.client import get_available_dates

Quickstart

Connect to a FlowMachine API and retrieve available dates.

from flowclient.client import FlowClient
import os

client = FlowClient(
    url=os.environ.get("FLOWKIT_URL", "http://localhost:9090"),
    token=os.environ.get("FLOWKIT_TOKEN", "")
)
try:
    print(client.get_available_dates())
except Exception as e:
    print(f"Error: {e}")