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.
- 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.
Note: Python 3.10 is required. While
WayFlowmight work on later versions, those have not been tested.
-
Clone the repository:
git clone https://github.com/oracle/wayflow.git
-
Create and activate a Python 3.10 virtual environment:
python3.10 -m venv <venv_name> source <venv_name>/bin/activate
-
Navigate to the project directory:
cd wayflowcore -
Run the installation script:
bash install-dev.sh
-
(For development) Install the pre-commit hooks:
pre-commit install
WayFlow documentation is available at the website. Most of the documentation sources can be found in the docs/ directory, organized in the same hierarchy as presented on the site.
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. |
Create a GitHub issue.
This project welcomes contributions from the community. Before submitting a pull request, please review the contributor guide.
Please refer to the security guide for information on responsibly disclosing security vulnerabilities.
Copyright (c) 2025 Oracle and/or its affiliates.
This software is under the Universal Permissive License (UPL) 1.0 (LICENSE-UPL or https://oss.oracle.com/licenses/upl) or Apache License 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0), at your option.
