WayFlow

WayFlow is a powerful, intuitive Python library for building sophisticated AI-powered assistants. It includes a standard library of plan steps to streamline the creation of AI-powered assistants, supports re-usability and is ideal for rapid development.

Get started

To get started, set up your Python environment (Python 3.10 or newer required), and then install the WayFlow Core package.

venv

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install wayflowcore

uv

You can also use uv for faster install times:

pip install uv
uv pip install wayflowcore

Hello world example

Initialize a Large Language Model (LLM) of your choice:

OCI Gen AI	Open AI	Ollama
from wayflowcore.models import OCIGenAIModel llm = OCIGenAIModel( model_id="provider.model-id", service_endpoint="https://url-to-service-endpoint.com", compartment_id="compartment-id", auth_type="API_KEY", )	from wayflowcore.models import OpenAIModel llm = OpenAIModel( model_id="model-id", )	from wayflowcore.models import OllamaModel llm = OllamaModel( model_id="model-id", )

See the list of supported LLMs in the WayFlow documentation.

Then, create an agent using a WayFlow Agent:

from wayflowcore.agent import Agent

assistant = Agent(llm=llm)

conversation = assistant.start_conversation()
conversation.append_user_message("I need help regarding my sql query")
conversation.execute()

# get the assistant's response to your query
assistant_answer = conversation.get_last_message()
assistant_answer.content
# I'd be happy to help with your SQL query...

For more information on how to build flexible Agents, structured Flows and multi-agent patterns, read the WayFlow Tutorials

Why WayFlow?

• Flexibility : WayFlow supports multiple approaches to building AI Assistants, including Agents and Flows.
• Interoperability : WayFlow works with LLMs from many different vendors and supports an open approach to integration.
• Reusability : WayFlow enables you to build reusable and composable components for rapid development of AI assistants.
• Extensibility : WayFlow has powerful abstractions to handle all types of LLM applications and provides a standard library of steps.
• Openness : WayFlow is an open-source project, welcoming contributions from diverse teams looking to take AI agents to the next step.

Positioning in the Agentic Ecosystem

WayFlow is the reference runtime implementation for Open Agent Spec.

Examples

Explore practical examples for working with WayFlow.

Name	Description
Build a Simple Conversational Assistant with Agents	A demo using dummy HR data to answer employee-related questions with an agent.
Build a Simple Fixed-Flow Assistant with Flows	A basic HR chatbot built as a fixed-flow assistant to answer employee questions.
Build a Simple Code Review Assistant	An advanced assistant using Flows to automate Python pull request reviews.

Get Support

• Open a GitHub issue for bug reports, questions, or requests for enhancements.
• Report a security vulnerability according to the Reporting Vulnerabilities guide.

Contributing

This project welcomes contributions from the community. Before submitting a pull request, please review the contributor guide.

Security

Please refer to the security guide for information on responsibly disclosing security vulnerabilities.

License

Copyright (c) 2025 Oracle and/or its affiliates.

This software is under the Apache License 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) or Universal Permissive License (UPL) 1.0 (LICENSE-UPL or https://oss.oracle.com/licenses/upl), at your option.