Documentation

Guides, API references, and troubleshooting for the Pyvorin platform.

edge intermediate

Actions and Events — Responding to the Edge

Attach callables to edge rules and handle Event objects safely: fail-open semantics, retries, and idempotent actions that survive crashes.

13 min read

getting-started intermediate

Activation and Entitlement

What pyvorin-native 1.0.9 does when you activate: the Ed25519-signed lease, device binding, gate semantics, anti-rollback, and the offline grace table per tier.

7 min read

edge advanced

Advanced Pipeline Patterns in Pyvorin Edge

Multi-stage pipelines, fan-out and fan-in, EWMA custom windows, and backpressure tuning for production edge workloads.

22 min read

guides intermediate

Alerting and Webhooks

pyvorin-native 1.0.9 has no webhook delivery. This page shows the verified alerting surfaces it does have and how to wire them into cron and CI.

advanced intermediate

Anomaly Detection with Pyvorin

Anomaly detection over streams works with Pyvorin when the detector is a compiled windowed aggregate behind the stream processor. Anchors, and the limits.

compiler-category intermediate

AOT vs JIT for Python: An Honest Comparison

Warm-up, peak performance, compatibility and running cost: the AOT vs JIT trade-offs for Python, the cases where each wins, and Pyvorin's position.

8 min read

integrations intermediate

Apache Airflow Integration

How to put Pyvorin-native compute inside an Airflow DAG: compile before the run, execute through the CLI, and keep a measured speedup on record in CI.

edge advanced

ARM64 NEON Vectorization in Pyvorin Edge

How Pyvorin Edge uses ARM64 NEON: which loops vectorise, realistic 2–8x expectations with caveats, and kernels the backend accepts.

14 min read

thin-client advanced

Artifact Caching, Explained

Where pyvorin-native 1.0.9 stores compiled code, how the cache key is built, what eviction costs, and the measured gap between a cold and a warm compile.

architecture intermediate

AST Analysis Phase

The first gate in the Pyvorin pipeline: what the AST walk looks for, what disqualifies a function, and how support tiers are assigned.

edge advanced

Audit Chain and Signed Reports

Build a tamper-evident audit chain on the edge: append-only logs, signed reports, lock scope, and the honest limits of tamper resistance.

18 min read

edge intermediate

AWS and Azure Integration

Wire Pyvorin Edge into AWS IoT Greengrass and Azure IoT Hub, with MQTT bridging and a worked egress cost comparison.

16 min read

cost-savings beginner

Batch Job Cost Optimisation

Batch pipelines are the clearest case where runtime becomes money. Measure the job, shorten it, then exploit spot capacity and scheduling windows.

benchmarks advanced

Benchmark Methodology: How We Measure

How every published Pyvorin figure is produced: harness conventions, the correctness gate, the two compiler paths, the autotune study, and how to rerun it.

10 min read

workloads intermediate

Benchmarking Correctly

Cold compiles, micro-workloads and single runs: the measurement mistakes that make benchmark numbers meaningless, and the verified commands that avoid them.

edge intermediate

Benchmarking with the Pyvorin Edge SDK

Benchmark Pyvorin Edge pipelines honestly: cost-model assumptions, warm-up discipline, a CI regression example, and micro-benchmark limits.

13 min read

getting-started intermediate

Benchmarks

Every measured CPython vs Pyvorin result across 71 workloads — the wins, the losses, and how to reproduce every number yourself.

3 min read

how-to intermediate

Caching Compiled Artifacts in CI

Skip the compile step on every repeated CI build: the verified pyvorin-native 1.0.9 cache locations, cache keys that actually hit, and the trap in cache clear.

guides

Capacity Planning

Estimate infrastructure needs after Pyvorin acceleration.

edge advanced

CloudSyncQueue API Reference

Full CloudSyncQueue API: SQLite schema, ack/nack semantics, priority and TTL, locking caveats, and store-and-forward telemetry patterns.

13 min read

architecture intermediate

Compiler Pipeline Overview

How Pyvorin turns a Python function into native machine code — every stage from parsing to the wrapper that makes the result callable.

compiler-category beginner

Compiling Python to Native Code: A Measured Walkthrough

One real Python function compiled to native code end to end — verified commands, captured output, a measured before-and-after, and the honest boundary cases.

10 min read

help

Contact & Support

How to get help, report issues, and reach the Pyvorin team.

workloads intermediate

Correctness Validation

pyvorin-native validates native output against CPython before trusting it: a ground-truth run in bench, a per-function oracle, drift and overflow fields.

edge advanced

Cross-Compiling Pyvorin Edge Kernels for ARM64

Toolchain setup, cross-compiled kernels, manifest verification and CI pipelines for ARM64 edge targets.

18 min read

edge advanced

Custom Adapters — Extending the Ingest Layer

Write duck-typed ingest adapters for Modbus, serial, or proprietary protocols: the read() contract, failure semantics, and a checklist.

15 min read

guides intermediate

Custom Benchmark Suites

Turn pyvorin bench --json into a repeatable suite: capture raw_times_ms, p95 and stddev per function, aggregate across a directory, and gate regressions in CI.

edge intermediate

Custom Cloud Endpoints

Build a receiver for Pyvorin Edge batches: payload schema, bearer auth, retry semantics, and Flask and FastAPI handler examples.

15 min read

integrations intermediate

Dagster Integration

Dagster assets backed by Pyvorin-native code need no plugin: compile the asset's compute ahead of time and materialise it through the verified CLI runner.

guides intermediate

Debugging Compiled Code

How to debug code compiled by Pyvorin Native 1.0.9: the support, explain and inspect commands, fallback reason chains, and cache forensics.

edge intermediate

Disaster Recovery and Data Integrity

A recovery playbook: WAL checkpointing, queue repair, automated backups, factory reset and how to test your restores.

18 min read

edge intermediate

Docker Deployment Guide

A production Docker setup for EdgeAgent: multi-stage builds, Compose, networking modes and secrets management.

24 min read

edge advanced

Ed25519 Trust Anchors

Ed25519 trust anchors for edge devices: key generation, signing, rotation schedules, and chaining into OTA updates and secure boot.

14 min read

guides intermediate

Edge and IoT Deployment

What pyvorin-native 1.0.9 can and cannot do at the edge: platform support, compile-then-deploy, offline licensing, and measured IoT benchmark numbers.

edge intermediate

Edge CLI Tools Reference

Every pyv-edge command with flags and exit codes, plus patterns for wiring the tools into CI pipelines.

15 min read

edge intermediate

Edge Configuration Reference

Every EdgeAgent configuration key explained: polling, storage, upload, dashboard, and licence settings, with reload caveats and examples.

22 min read

edge beginner

Edge Dashboard Overview

The built-in EdgeAgent dashboard: access options on :8080, the security warning that matters, per-view metrics, and reverse-proxy placement.

12 min read

edge beginner

Edge Project Structure

A directory map of a production Pyvorin Edge deployment: config, adapters, queues, logs, and keys — what lives where and what to back up.

10 min read

edge beginner

Edge Quick Start

A working Pyvorin Edge pipeline in fifteen minutes: install, first sensor feed, first rule, and verified expected output at every step.

14 min read

edge beginner

Edge System Requirements

Hardware and OS requirements for Pyvorin Edge on x86_64 and ARM64: device-class tables, storage budgets, and deployment constraints.

12 min read

edge advanced

EdgeAgent API Reference

Complete EdgeAgent API: lifecycle methods, threading model, signal handling, and graceful shutdown — the operational counterpart to the tour.

14 min read

cost-savings advanced

Enterprise Licence vs Building In-House

An in-house compiler is a multi-year staffing programme. A labelled model weighs team cost, timeline and opportunity cost against verified pricing.

guides intermediate

Error Handling and Diagnostics

How pyvorin-native 1.0.9 fails and reports: the four compile outcomes, verified exit codes, guard failure semantics, and where every diagnostic record lives.

case-studies intermediate

Example Workload: ETL Pipeline

An illustrative ETL pipeline with acceleratable stages (transforms, windowed aggregates) and non-acceleratable ones (CSV parsing, joins) separated by evidence.

case-studies intermediate

Example Workload: Financial Risk Calculations

An illustrative financial-risk batch dissected stage by stage: Monte Carlo, correlations and moving averages — what a compiler accelerates, what it cannot.

case-studies intermediate

Example Workload: Log Analytics

An illustrative log-analytics pipeline dissected stage by stage: where native compilation wins, where parsing-bound stages do not, and the measured anchors.

case-studies intermediate

Example Workload: ML Feature Engineering

An illustrative ML feature pipeline split into what a compiler accelerates — aggregations, transforms — and what it cannot: histograms, string features, I/O.

thin-client advanced

Fallback Behaviour, Deep Dive

Every way pyvorin-native 1.0.9 declines to run native code, what each fallback costs, the reason strings the tools emit, and when fallback means restructure.

edge intermediate

Field Redaction Patterns

Five field-level redaction actions for edge telemetry — drop, mask, hash, generalise, tokenise — with performance notes and ordering pitfalls.

16 min read

edge intermediate

FileReplayAdapter — Time-Travel for Sensor Data

Replay recorded sensor data through a live pipeline with FileReplayAdapter: pacing modes, loop behaviour, and reproducible tests.

12 min read

edge beginner

Five-Minute Tour

A five-minute story: install Pyvorin Edge, start the agent, watch live data on the dashboard, add a rule and trigger an event.

14 min read

edge advanced

Fleet Management at Scale

Operating hundreds of gateways: provisioning, drift detection, bulk configuration, fleet-wide rollback and health aggregation.

26 min read

edge beginner

Frequently Asked Questions

Plain-language answers on installing, configuring, tuning and licensing Pyvorin Edge, plus where to go when stuck.

15 min read

edge intermediate

GDPR and NIS2 Compliance

A practical route to GDPR and NIS2 compliance: records of processing, retention, erasure, breach timelines and audit evidence.

16 min read

guides

Green Computing

Reduce energy consumption and carbon footprint with faster Python.

architecture advanced

Guards and Deoptimisation

The contract behind Pyvorin compiled code: what guards protect, what happens when one fails, and why a failed guard can never corrupt your program semantics.

edge advanced

Hashing Strategies for Correlation

SHA-256, HMAC, and salted hashing for privacy-safe correlation on the edge: production examples, brute-force limits, and when to avoid it.

15 min read

edge intermediate

Health Monitoring and Prometheus Export

Health endpoints, Prometheus metrics, a ready Grafana dashboard and Alertmanager rules for EdgeAgent fleets.

20 min read

advanced intermediate

High-Frequency Data Feeds

On high-frequency feeds, Pyvorin accelerates ingestion-side batch transforms, not the wire path. Measured anchors and where to draw the boundary.

python-features advanced

How For Loops Compile

The loop passes of the Pyvorin 1.0.9 pipeline — complete unrolling, the vectorisation cost model, loop fusion — with the exact thresholds, verified in source.

architecture intermediate

How Local Compilation Works

The full path from import through compilation to native execution in pyvorin-native 1.0.9 — where the cache lives, what the fallback does, and exactly what does and does not leave the machine.

10 min read

how-to beginner

How to Benchmark a Function

From a Python file to a defensible speedup number in minutes: the verified commands, the fields that matter, and the checks before you trust it.

how-to beginner

How to Compile Your First Function

From a saved .py file to a natively compiled function in four verified commands, with the output you should expect at each step and the failure modes explained.

how-to beginner

How to Force the CPython Fallback

The verified ways to get pure-CPython behaviour in pyvorin-native 1.0.9: the cpython backend, PYVORIN_BACKEND, run --compare, and fallback in bench --json.

how-to intermediate

How to Handle Compilation Failure

Compilation failure in pyvorin-native 1.0.9 almost never means a crash: the verified taxonomy, what each status means, and how to get per-function reasons.

how-to intermediate

How to Run a Speed Proof

The measurement a sceptical CFO could audit: captured baseline, warmed runs, median-of-N, correctness check, compile-time amortisation, and an honest write-up.

python-features advanced

How While Loops Compile

While loops compile natively in Pyvorin 1.0.9, but their trip count is data — this page shows the verified lowering and which optimisations that fact excludes.

edge intermediate

HTTPAdapter — REST, Webhooks, and Polling Ingest

HTTPAdapter for edge pipelines: inbound REST and webhook ingest, outbound polling, authentication headers, TLS, and key security notes.

14 min read

edge intermediate

HTTPCloudUploader Configuration

Configure HTTPCloudUploader end to end: retry internals, backoff, TLS verification, batch sizing, and draining the local sync queue.

13 min read

implementation intermediate

Implementing Pyvorin at the Edge

Edge deployment with Pyvorin Native 1.0.9: compile on an x86_64 build host, ship the compiled cache, and activate per device within its offline grace window.

implementation intermediate

Implementing Pyvorin in Microservices

Compile CPU-bound services at build time, ship the artefacts in the image, and skip the compiler sidecar. Which service shapes benefit, which do not, and why.

edge beginner

Installing Pyvorin Edge

Install Pyvorin Edge on x86_64 or ARM64 Linux: prerequisites, verified steps, expected output at each stage, and fixes for common failures.

15 min read

guides beginner

Licence Management and Billing

Pyvorin Native licensing, verified against 1.0.9: the activate/status/check commands, licence file fields, device binding, grace periods and plan pricing.

edge intermediate

LicenseValidator API Reference

Every LicenseValidator class, enum and environment variable, including local file format and the local-vs-remote validation cascade.

12 min read

architecture advanced

LLVM IR Generation

How pyvorin-native 1.0.9 lowers a typed Python function to LLVM IR through llvmlite — with a real before-and-after example taken from the compiler's own output.

performance intermediate

Making Python ETL Pipelines Faster, Measured

Measured per-transform ETL results: windowed aggregates to 134.62x, merge joins to 0.64x — which transforms accelerate, which do not, and where the seam sits.

8 min read

adoption intermediate

Measuring Pyvorin Adoption

Metered credits do not exist in pyvorin-native, so they cannot measure adoption. Five verified metrics can: coverage, deltas, cache, fallback, correctness.

migration intermediate

Migrating from Cython to Pyvorin

What Cython's static typing bought you, what changes when the annotations come off, which modules should stay, and the commands to prove each migration.

migration intermediate

Migrating from Numba to Pyvorin

What @njit gave you, what Pyvorin compilation gives you instead, which kernels should stay on Numba, and how to verify each migrated function.

edge intermediate

MQTTAdapter — Broker Subscriptions and Resilient Ingest

MQTTAdapter for resilient edge ingest: QoS semantics, TLS, reconnect and back-off behaviour, and durable local buffering during outages.

14 min read

edge advanced

mTLS and Certificate Pinning

A full mTLS lifecycle for edge fleets: private CA, per-device certificates, adapter configuration, rotation and revocation.

20 min read

architecture advanced

Native Code Generation

How pyvorin-native 1.0.9 turns LLVM IR into a loadable shared object: object emission, linking against the runtime, and when SIMD vectorisation fires.

architecture intermediate

Network Requirements for Pyvorin

Every endpoint pyvorin-native 1.0.9 contacts, when each fires, offline grace windows, air-gap implications, TLS, and the env overrides that redirect traffic.

7 min read

edge advanced

Offline-First Operation

Run edge pipelines through WAN outages: SQLite WAL, circuit breakers, store-and-forward queues, and recovery behaviour that prevents data loss.

16 min read

edge advanced

Over-the-Air Update System

Signed bundles, version manifests, atomic swap and rollback: a safe OTA design for field gateways.

28 min read

edge advanced

Pipeline API Reference

Complete Pipeline API: ingest, window, rule, and action methods with signatures, return types, and the locking behaviour to plan around in production.

16 min read

integrations intermediate

Prefect Integration

A Prefect flow running Pyvorin-native code needs no plugin: compile the step ahead of time, launch it from a task, and keep the measurement.

edge intermediate

Privacy Filtering Overview

Privacy filtering for edge telemetry: regulatory context (GDPR, NIS2), filtering stages, measured overhead, and field-level options.

14 min read

edge intermediate

Production Deployment Checklist

The pre-flight and post-deployment checks that keep EdgeAgent gateways secure, backed up and observable.

22 min read

edge intermediate

Profiling Edge Pipelines and System Metrics

Profile edge pipelines in place: cProfile on hot rules, memory measurement, system metrics, and how to read results without fooling yourself.

12 min read

guides intermediate

Programmatic API Usage

Using pyvorin-native 1.0.9 as a library: PyvorinCompiler, result objects, diagnostics, @kernel and the cache — all probed against the installed build.

architecture advanced

Protected Component Delivery and Verification

Every file in pyvorin-native 1.0.9 ships in the wheel and is SHA256 hash-checked at import. The Ed25519 manifest and cache signatures are not yet active in the shipped build — here is exactly what is and is not verified today.

8 min read

performance intermediate

Python Log Processing Performance

Parsing log lines is already fast under CPython — measured 0.86x compiled. The wins live in the aggregation layer behind the parser; here is the measured map.

8 min read

security intermediate

Pyvorin and HIPAA

Pyvorin is a build tool, not a system that touches PHI: under pyvorin-native, source stays on the machine and the network surface is two endpoints.

security intermediate

Pyvorin and SOC 2

No SOC 2 audit covers pyvorin-native as of 1.0.9. What exists is a set of controls you can execute and verify yourself, mapped to common criteria categories.

reference beginner

Pyvorin CLI Reference

Two command surfaces ship in pyvorin-native 1.0.9 — the pyvorin console script and the python -m pyvorin product CLI. This reference documents both.

edge intermediate

Pyvorin Edge Plugin Architecture

How the entry-point plugin system works, from discovery to a complete custom adapter with configuration.

20 min read

edge expert

Pyvorin Edge Runtime Library Internals

A deep dive into the runtime: typed containers, signature checks, guarded fallback and the ctypes ABI layer.

28 min read

industries intermediate

Pyvorin for Algorithmic Execution

Slicing schedules, market-impact research and pre-trade analytics are legitimate compiler targets; the hot order loop on a microsecond budget is not.

industries intermediate

Pyvorin for Fraud Detection

Batch scoring grids, feature aggregation and anomaly loops are strong measured matches; inline authorisation-path scoring is not a compiler problem.

industries intermediate

Pyvorin for Quantitative Trading

Backtests, signal generation and portfolio simulations accelerate well; market-data parsing and the live order path do not. A candid map of the boundary.

industries intermediate

Pyvorin for Regulatory Reporting

Report pipelines split cleanly: enrichment, validation and aggregation loops have strong measured anchors; parsing, joins and formatting regress.

industries intermediate

Pyvorin for Risk Management

Monte Carlo simulation, correlation matrices and stress-test grids are strong measured matches; intraday limit monitoring on a latency budget is not.

cost-savings beginner

Pyvorin for Startups on a Budget

Verified pricing, a labelled runway model, and the discipline that saves startups money: measure first, buy the tier that fits.

security intermediate

Pyvorin GDPR Considerations

Source never leaves the machine under pyvorin-native, telemetry carries event metadata only, and the device fingerprint is personal data.

security intermediate

Pyvorin in Air-Gapped Environments

Compilation needs no network at all. Licensing degrades slowly: offline-valid leases keep passing, and grace runs from 24 hours to 90 days by tier.

containers intermediate

Pyvorin in Docker: Best Practices

Compile in the builder stage, ship the disk cache in the image, and activate at container start. The Docker practices that matter for Pyvorin Native 1.0.9.

cloud intermediate

Pyvorin on AWS

The practical AWS guide for Pyvorin Native 1.0.9: instance constraints, baking compiled artefacts into an AMI, Auto Scaling, and a labelled cost model.

adoption intermediate

Pyvorin Rollout Playbook

One CPU-bound pilot, a proof built on measured numbers, written success criteria, staged rollout and a clean rollback story — the Pyvorin adoption sequence.

comparisons intermediate

Pyvorin vs Codon

Codon compiles Python-syntax code to standalone native binaries; Pyvorin compiles the Python you already run, in-process, beside CPython. Where each fits.

comparisons intermediate

Pyvorin vs CPython

Pyvorin runs your existing Python as native machine code beside CPython. Where that helps, where it does not, and the measured results from 71 workloads.

cost-savings intermediate

Pyvorin vs CPython: A Total-Cost View

More than the compute line — a labelled three-year illustrative model comparing the same Python workload under CPython alone versus CPython with Pyvorin.

comparisons intermediate

Pyvorin vs Cython

Cython asks you to maintain a second language for speed. Pyvorin compiles the Python you already have. The right choice depends on who owns the code.

comparisons intermediate

Pyvorin vs Mojo

Mojo and Pyvorin both promise Python-like ergonomics with native performance, but they answer different questions. Goals, fit, and honest trade-offs.

comparisons intermediate

Pyvorin vs Nuitka

Nuitka's deliverable is a binary you can hand to a customer. Pyvorin's deliverable is speed inside the Python environment you already run. Choose accordingly.

comparisons intermediate

Pyvorin vs Numba

Both tools turn Python into machine code through LLVM. The deciding factor is what your slow code looks like — and this page shows how to find out.

comparisons intermediate

Pyvorin vs PyPy

PyPy replaces CPython with a faster interpreter and asks for nothing. Pyvorin keeps your runtime and compiles the hot paths. Compatibility decides most battles.

getting-started beginner

Quick Start

Install pyvorin-native, activate your licence, and benchmark your first Python function locally — every command on this page verified against the shipped 1.0.9 build.

cost-savings intermediate

Reducing Cloud Compute Bills

Where a measured speedup becomes a smaller bill, where it does not, and a labelled illustrative model covering spot capacity, autoscaling and reservations.

performance intermediate

Reducing Python CPU Usage Without Rewriting

Profile first, compile what the profile points at: a measured workflow for lower Python CPU usage, the workloads where it works, and a labelled capacity model.

8 min read

edge intermediate

Rules and Conditions — Logic at the Edge

Ten concrete rule and condition examples for edge pipelines: thresholds, hysteresis, isolation tests, and the patterns that avoid false alarms.

16 min read

edge intermediate

Running EdgeAgent Under Systemd

A hardened unit file for EdgeAgent, with graceful shutdown, resource limits, journald logging and socket activation caveats.

18 min read

how-to intermediate

Running Pyvorin Natively on Your Own Hardware

pyvorin-native has no remote compile mode to opt into — local compilation is the architecture. What runs on your hardware, and what the only network calls do.

architecture advanced

Runtime Libraries

What pyvorin-native 1.0.9's runtime libraries do: typed containers, the Python–native ABI, CPython interop, and where the runtime itself limits speed.

security beginner

Secret Management with Pyvorin

Pyvorin's secret surface is small: one licence key, stored at 0600, bound to the machine, transmitted only over TLS. What the package does with it, verified.

edge advanced

Secure Boot and Runtime Integrity

Secure boot on the Pi, signed kernel modules, runtime integrity checks and hardware attestation for edge devices.

22 min read

help intermediate

Security and Source Privacy

What pyvorin-native 1.0.9 sends off your machine, what never leaves it, the pyvorin-thin warning, and the set_privacy opt-out — verified on the installed build.

guides intermediate

Security Best Practices

The verified security posture of pyvorin-native 1.0.9: what the product guarantees, what it does not, and the practices that keep it sound.

edge intermediate

SensorReading API Reference

SensorReading API reference: constructor fields, unit handling, the dual-definition caveat, and validation behaviour at the edge.

10 min read

edge beginner

SensorReadings — The Data Currency of the Edge

SensorReading objects carry every measurement through a Pyvorin Edge pipeline: fields, units, timestamps, and how they differ from the raw API type.

12 min read

cost-savings intermediate

Server Consolidation with Pyvorin

Fewer servers is the goal; safe consolidation is the method. Measure first, keep the redundancy floor, treat freed capacity as headroom before saving.

edge beginner

SimulatorAdapter — Synthetic Data for Real Testing

SimulatorAdapter generates realistic sensor traffic — noise, drift, anomalies — so you can test pipelines before any hardware exists.

14 min read

guides

SLIs and SLOs

Define service level indicators for compiled Python services.

edge intermediate

Structured Log Management and Shipping

Practical log management for gateways: structlog, rotation, shipping to Loki, Splunk or CloudWatch, and correlation IDs.

18 min read

security advanced

Supply Chain Security

One wheel, 5,098 hash-listed files, enforced integrity checks at import — and a manifest signature not yet active. The honest supply-chain inventory.

workloads beginner

Supported Workloads

Measured across 71 workloads: numerical, object-manipulation, image and financial code win big; string, parsing and compression do not. Check yours in minutes.

thin-client intermediate

Telemetry and Privacy

Event types, sampling, the bulk endpoint, envelope fields, privacy levels, and client-side inspection — the pyvorin-native 1.0.9 telemetry system, precisely.

edge intermediate

Testing Pyvorin Edge Pipelines

The testing pyramid for edge pipelines: unit tests, property tests, integration runs, coverage gates and mutation testing.

18 min read

edge advanced

The @edge Decorator — Under the Hood

How @edge compiles decorated functions on the device: AST parsing, signature inference, scalar versus kernel routing, and known limitations.

15 min read

edge advanced

The GIL and Threading in Pyvorin Edge

Where the GIL bites, when compiled kernels release it, and how to choose thread versus process pools for edge workloads.

20 min read

edge intermediate

The Pipeline Class — Ingest, Window, Evaluate, Act

How the Pipeline class works conceptually: dataflow from ingest through windowing and rules to actions, and where the API reference takes over.

15 min read

help beginner

Troubleshooting

The verified troubleshooting guide for pyvorin-native 1.0.9 — the errors you will actually meet, what causes each, and the fix that works.

edge beginner

Troubleshooting Installation

A diagnostic manual for installation failures: permission errors, missing Python headers, NEON build failures, port conflicts and more.

16 min read

edge intermediate

Tutorial: Cold Chain Monitoring for Pharmaceuticals

A complete GDP cold-chain pipeline: excursion rules, patient-field redaction, signed audit records and offline buffering.

25 min read

edge intermediate

Tutorial: Precision Agriculture and Smart Irrigation

Soil-moisture rules, weather-driven irrigation, a solar power budget and fleet rollout for remote fields.

25 min read

edge intermediate

Tutorial: Predictive Maintenance with Vibration Analysis

Vibration baselines, a NEON-compiled hot-path, threshold tuning and the business case for early fault detection.

25 min read

edge intermediate

Tutorial: Smart Building Energy Monitor

From Modbus meters to a live dashboard: pipeline configuration, cloud sync and the readings behind each panel.

30 min read

edge intermediate

Tutorial: Telecom Tower Monitoring and Safety

SNMP telemetry, multi-sensor pipelines, tower-climb safety rules and MQTT integration with the NOC.

35 min read

architecture advanced

Type Inference System

Dynamic Python in, static native code out: how Pyvorin infers types, what it assumes, and how guards keep wrong assumptions harmless.

edge advanced

Understanding the EdgeAgent

The EdgeAgent lifecycle deep-dive: startup, pipeline supervision, signal handling, and shutdown — the concepts behind the API reference.

20 min read

workloads intermediate

Unsupported Code and the Fallback Path

When Pyvorin cannot take a function native, your code still runs — via a recorded, per-call fallback to lazily compiled CPython. Here is exactly how that works.

guides intermediate

Warm-Up and Caching Strategies

Where pyvorin-native 1.0.9 caches compiled code, what a cache hit is worth in measured milliseconds, and how to key the cache in CI.

compiler-category beginner

What AOT Compilation Means for Python

Interpreters, JITs and AOT compilers for Python: how each works, when each wins, and where Pyvorin Native 1.0.9's local compilation fits.

10 min read

edge beginner

What Is Pyvorin Edge?

What Pyvorin Edge is, how its three pillars work, and when a gateway-native runtime beats shipping every reading to the cloud.

18 min read

performance beginner

Why Python Is Slow — and What Actually Helps

Bytecode dispatch, boxing and reference counting: where Python's time actually goes, the honest hierarchy of fixes, and what measurement says each one buys.

9 min read

edge intermediate

Window Aggregation — Rolling, Tumbling, and Custom Functions

How rolling, tumbling and session windows aggregate sensor streams, which built-in functions exist, and the performance caveats.

14 min read

edge intermediate

Writing Compiler-Friendly Python for Pyvorin Edge

Patterns that compile well on the edge device: stable types, simple control flow, and the habits that force the compiler to bail out.

12 min read

edge advanced

Writing Custom C Kernels for Pyvorin Edge

The full path from C source to loaded kernel: ABI contract, NEON intrinsics, the shared object, and verification at load time.

25 min read