🔗 WayFlow Core

WayFlow Core is the foundational Python library of the WayFlow ecosystem. It provides the runtime engine, abstractions, and components needed to build powerful AI assistants using Agents, Flows, or hybrid architectures.

WayFlow Core is:

• 🔧 Flexible — Build assistants using Agents, Flows, or both
• 🔗 Interoperable — Works with OCI GenAI, OpenAI, Ollama, and other LLM providers
• 🧩 Composable — Encourages modular, reusable building blocks
• 🚀 Extensible & Open — Designed for advanced agentic applications

⚡ Quick Install

pip install wayflowcore

(Optional, faster installation using uv)

pip install uv
uv pip install wayflowcore

🧠 Quick Start

1. Initialize an LLM

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",
)

2. Create an Assistant

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...

🧩 What You Can Build

WayFlow Core supports a wide range of agentic patterns:

• 💬 Conversational assistants
• 🔁 Flow-based assistants with structured sequencing
• 🤝 Multi-agent systems
• 🛠️ Tool-calling agents
• 🧪 Automated code review assistants
• 📚 Domain-specific knowledge assistants

💁 Contributing

Contributions are welcome! Please refer to the contributor guide located at the root of the repository.

🔐 Security

For responsibly reporting security issues, please refer to the project's security guidelines.

📄 License

WayFlow Core is dual-licensed under:

• Apache License 2.0 – see LICENSE-APACHE.txt
• Universal Permissive License (UPL) 1.0 – see LICENSE-UPL.txt