orca-python 0.9.0

Python SDK for the Predixus Orca product

🐳 Orca Python SDK

The Orca Python SDK enables developers to define and register Python-based algorithms into the Orca framework.

Orca exists to make it seamless to build scalable, production-grade ML or analytics pipelines on timeseries data.

🚀 Getting Started

Before using this SDK, you should install the Orca CLI and start Orca Core.

1. Install the Orca CLI Ensure that Docker is installed on your system.

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/orc-analytics/orca/main/install-cli.sh | bash

Windows

Use WSL (Windows Subsystem for Linux) and run the above command inside your WSL shell.

Once installed, follow the instructions in the Orca documentation to start the Orca Core service.

2. Start the Orca Server

orca start

3. Print out the server details

orca status

4. Install the Orca sdk into your python project:

pip install orca-python

5. Start building out your algorithms

Write a file defining your algorithms and what windows trigger them:

# main.py
from orca_python import Processor

proc = Processor("ml")

@proc.algorithm("MyAlgo", "1.0.0", "MyWindow", "1.0.0")
def my_algorithm() -> dict:
return {"result": 42}

if __name__ == "__main__":
proc.Register()
proc.Start()

Then run your python file to register it with orca-core:

 ORCA_CORE=grpc://localhost:32770 PROCESSOR_ADDRESS=172.18.0.1:8080 python main.py

Replace the contents of ORCA_CORE and PROCESSOR_ADDRESS with the output of orca status.

6. Emit a window to orcacore

Check out more examples here.

Environment Variables

Several environment variables are require to register an Orca Processor:

• ORCA_CORE - the address to reach the Orca-core service
• PROCESSOR_ADDRESS - the address needed by Orca-core to reach the processor, of format <address>:<port>
• PROCESSOR_EXTERNAL_PORT - an optional alternative port that should be used by Orca-core to contact the processor. Useful in scenarios like deploying the processor behind a managed service.

🧱 Key Concepts

Checkout the Orca docs for info on how Orca works.

👥 Community

GitHub Issues: https://github.com/orc-analytics/orca-python/issues

Discussions: Coming soon!

📄 License

This SDK is part of the Orca ecosystem, but licensed under the MIT License.

See the full license terms (here)[./LICENSE].