Xpectra Python SDK 🚀
The official Python SDK for Xpectra. This library provides a high-level, fluent API for telemetry discovery, ingestion, and querying.
✨ Features
- Fluent Discovery: Easily browse experiments, datasets, and channels.
- Strictly Typed: Full Python types for experiments, datasets, and sensors.
- Pandas Integration: Load telemetry data directly into DataFrames.
- Batch & Stream Ingest: Support for high-performance telemetry submission.
- Org-scoped Auth: Secure authentication using organization API keys.
📦 Installation
# Using uv (recommended)
uv add xpectra-client
# Using pip
pip install xpectra-client
🚀 Quick Start
from xpectra import Client
import pandas as pd
from datetime import datetime
# Initialize the client
client = Client(
api_key="sk_xp_...",
endpoint="localhost:50051", # gRPC ingest endpoint
base_url="http://localhost:3000" # Web API base URL
)
# 1. Discover data
dataset = client.get_dataset("Pulse 3", experiment_id="...")
print(f"Dataset status: {dataset.metadata.status}")
# 2. Ingest data
df = pd.DataFrame({
"Temperature": [22.5, 23.1],
"Pressure": [1013, 1012]
}, index=[datetime.now(), datetime.now()])
dataset.ingest(df)
# 3. Load data
loaded_df = dataset.load(limit=100)
print(loaded_df.head())
📚 Examples
Check the examples/ directory for more:
full_client_demo.py: Comprehensive metadata and discovery walkthrough.stream_csv.py: Ingest data from CSV files.api_key_auth.py: Authentication patterns.
🔐 Authentication
Generate your API key in the Xpectra dashboard under Settings → API Keys.
© 2026 Xpectra. All rights reserved.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xpectra_client-0.1.0.tar.gz.
File metadata
- Download URL: xpectra_client-0.1.0.tar.gz
- Upload date:
- Size: 62.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b7237b87d83c016a57d88ef8ec589d8acf9537e1dec5592a9546c88efdcf3754
|
|
| MD5 |
94f4da6b1be3b52d1560f955c46f4de7
|
|
| BLAKE2b-256 |
a001c6a4cd01a45c752c219cced693c541fa6df51b07ed26dd4f331145921d21
|
Provenance
The following attestation bundles were made for xpectra_client-0.1.0.tar.gz:
Publisher:
publish.yml on xpectraflow/xpectra-client
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xpectra_client-0.1.0.tar.gz -
Subject digest:
b7237b87d83c016a57d88ef8ec589d8acf9537e1dec5592a9546c88efdcf3754 - Sigstore transparency entry: 2207235778
- Sigstore integration time:
-
Permalink:
xpectraflow/xpectra-client@8b790595d25be705976001f77f1e5cad07617d98 -
Branch / Tag:
refs/tags/v0.0.0 - Owner: https://github.com/xpectraflow
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8b790595d25be705976001f77f1e5cad07617d98 -
Trigger Event:
release
-
Statement type:
File details
Details for the file xpectra_client-0.1.0-py3-none-any.whl.
File metadata
- Download URL: xpectra_client-0.1.0-py3-none-any.whl
- Upload date:
- Size: 12.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb0ecd9049353ef94e069935e7760c1ad51fe3f4275d45d21abb27bb8abfe73f
|
|
| MD5 |
d9e486f3fc4ac184360ce2db81412589
|
|
| BLAKE2b-256 |
b436316880d3ca47dddb97da24972d4804a3675ea74466854a3ee8fc5a7c73b1
|
Provenance
The following attestation bundles were made for xpectra_client-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on xpectraflow/xpectra-client
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xpectra_client-0.1.0-py3-none-any.whl -
Subject digest:
cb0ecd9049353ef94e069935e7760c1ad51fe3f4275d45d21abb27bb8abfe73f - Sigstore transparency entry: 2207235792
- Sigstore integration time:
-
Permalink:
xpectraflow/xpectra-client@8b790595d25be705976001f77f1e5cad07617d98 -
Branch / Tag:
refs/tags/v0.0.0 - Owner: https://github.com/xpectraflow
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8b790595d25be705976001f77f1e5cad07617d98 -
Trigger Event:
release
-
Statement type:
