Oxy is an open-source framework for agentic analytics. It is declarative by design and written in Rust. Oxy is built with the following product principles in mind: open-source, performant, code-native, declarative, composable, and secure.

Agentic analytics applies software development lifecycle principles to AI-driven data analytics.

Just as traditional software follows a build-test-deploy pipeline, agentic analytics establishes a structured workflow for data agents, involving agent creation, prompt testing, and production deployment.

Specifically, this process is implemented as follows:

  • Agent Configuration: Define agents using .agent.yml files that specify their instructions. Provide context through .sql and .sem.yml files that supply queries and semantic information, respectively.

  • Workflow Development: Create .workflow.yml files to orchestrate multi-step processes. Chain validated agents and tasks together into reusable, production-ready automations.

  • Testing Framework: Add test cases directly to .agent.yml or .workflow.yml files. Execute tests using the oxy test command.

You can run individual agents with oxy run path/to/agent_name.agent.yml "question" or execute complete workflows using oxy run path/to/workflow_name.workflow.yml.

​
Resources

​
Get started

If you’re new to Oxy start here to learn the essentials.

Quickstart

Basic Oxy commands

​
Developer Basics

If you’re new to development, these resources will help you get started.

CLI Commands

CLI Shortcuts

Github Basics

Learn the basics of Github