bioprocess-intelligence 0.1.7

A Python client for interacting with the Bioprocess Intelligence platform

Bioprocess Intelligence Python Client

This is the official Python client for interacting with Bioprocess Intelligence – a comprehensive platform for digital bioprocess development and operation.

The client provides programmatic access to the Bioprocess Intelligence API, enabling users to integrate, manage, and analyze bioprocess data. It supports common operations such as managing teams, collections, and processes, and importing structured data from various formats.

As the platform evolves, the client will be extended to cover additional capabilities including real-time data integration, statistical analysis, mechanistic modeling, and more.

---

Features

• Authenticate using environment variables.
• List teams and collections.
• Create, retrieve, update, and delete processes.
• Import process data from YAML content.
• Monitor background tasks.

---

Installation

pip install bioprocess-intelligence

---

Getting Started

1. Create a .env file in your project root:

BPI_API_URL=https://your-api-url
BPI_USERNAME=your_username
BPI_PASSWORD=your_password

2. Use the following boilerplate code to initialize the client:

from bioprocess_intelligence.client import BioprocessIntelligenceClient
import os
from dotenv import load_dotenv
from pathlib import Path

load_dotenv(Path(__file__).parent / ".env")

client = BioprocessIntelligenceClient(
    api_url=os.getenv("BPI_API_URL"),
    username=os.getenv("BPI_USERNAME"),
    password=os.getenv("BPI_PASSWORD")
)

---

Example Usage

List Teams

teams = client.list_teams()
print("Teams:", teams)

Get Collections in a Team

collections = client.list_collections(team_id=5)

Get or Create a Process

try:
    process = client.get_process(name="New process", collection_id=123)
except:
    process = client.create_process(
        name="New process",
        collection_id=123
    )

Update a Process

process = client.update_process(
    process_id=process['id'],
    name="Updated name",
    description="Updated description",
    start_time="2024-01-01T10:00:00+01:00",
    end_time="2024-01-07T15:00:00+01:00"
)

Delete a Process

client.delete_process(process['id'])

---

Importing Process Data

From YAML Content

from pathlib import Path

script_dir = Path(__file__).parent
yaml_file = script_dir / "files/process_import_template_v1.yaml"

try:
    content = yaml_file.read_text(encoding="utf-8")
    result = client.import_process_from_yaml(
        collection_id=123,
        content=content,
        timezone="UTC"
    )
    print("Import result:", result)
    client.monitor_background_task(result["backgroundTaskId"])
except Exception as e:
    print(f"Error importing process from YAML: {e}")

This allows you to send the full YAML string directly to the API, without using file uploads.

---

Error Handling

Make sure to wrap API calls in try-except blocks to handle errors gracefully, especially when importing data or querying resources.

---

License

This client is proprietary software distributed in binary form.

• Free for academic and non-commercial research use
• A commercial license is required for any commercial or for-profit use

To request a commercial license, please contact us at [e-mail].