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:

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.

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.