Install & Compatibility
Where this runs
tested against v1.2.13 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.13
✕ build_error
✕ build_error
621MB installed
● package 621MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
TectonClient
✓ from tecton import TectonClient
FeatureView
✓ from tecton import FeatureView
Used for defining new feature views.
get_workspace
✓ from tecton import get_workspace
Used to connect to a specific Tecton workspace context.
batch_materialization
✓ from tecton import batch_materialization
Helper for configuring batch materialization.
RequestSource
✓ from tecton import RequestSource
Used for defining request-time features.
Demonstrates how to initialize the Tecton client using an API key from environment variables and fetch online features from an existing Feature Service. This example requires a configured Tecton workspace and Feature Service to run successfully.
import os
from tecton import TectonClient
# --- IMPORTANT: Setup for quickstart ---
# 1. Set your Tecton API key as an environment variable:
# export TECTON_API_KEY="YOUR_API_KEY"
# 2. Replace 'your_workspace_name' with an actual workspace you have access to.
# (Find in Tecton UI or via `tecton list workspaces` CLI command)
# 3. Replace 'your_feature_service_name' and 'your_join_key' with actual values.
# (Requires an existing FeatureService in your workspace)
# -------------------------------------------
api_key = os.environ.get('TECTON_API_KEY', '')
if not api_key:
print("Warning: TECTON_API_KEY environment variable not set. This example will likely fail.")
# In a real application, you might raise an error or exit.
# Initialize the Tecton client
try:
client = TectonClient(
workspace_name='your_workspace_name', # e.g., 'prod'
api_key=api_key
)
print(f"Successfully connected to Tecton workspace: {client.workspace_name}")
# Example: Get online features for a specific entity.
# This assumes you have a FeatureService configured in your workspace.
# and it expects a specific join key (e.g., 'user_id').
feature_service_name = "your_feature_service_name" # e.g., 'user_transaction_counts_fs'
join_keys = {"your_join_key": "entity_id_example"} # e.g., {"user_id": "user_123"}
# Fetch features
feature_vector = client.get_online_features(
feature_service_name=feature_service_name,
join_keys=join_keys
)
if feature_vector and not feature_vector.empty:
print(f"\nSuccessfully retrieved features from {feature_service_name}:")
print(feature_vector.to_pandas())
else:
print(f"\nNo features retrieved or feature vector is empty for {feature_service_name} with join keys {join_keys}.")
print("Please check FeatureService name, join keys, and if features are materialized.")
except Exception as e:
print(f"\nError during Tecton client initialization or feature retrieval: {e}")
print("Ensure your TECTON_API_KEY is valid, workspace_name exists, and network connectivity is present.")
tecton --version
Upgrade
Version history
1.2.13latest on PyPI · released Dec 5, 2025
Audit
Dependencies
No dependency data recorded yet.