Author or serialize a flow as a diagramYou can write a whole flow as a mermaid flowchart and compile it by passing the string to flow(). Any flow renders back with String(flow), so the diagram and the program stay in sync.cppacademyacademy/topics/flow-mermaidwebsite/content-src/academy/course.mjsacademyAuthor or serialize a flow as a diagram
You can write a whole flow as a mermaid flowchart and compile it by passing the string to flow(). Any flow renders back with String(flow), so the diagram and the program stay in sync.
flow(mermaid)7 focused minutesNot started
Unit example (nearest native match)
See the idea in context
std::string mermaid = R"(flowchart TD
%%ax classify: request:string -> route:class "support, sales"
classify{route})";
auto program = axllm::flow(mermaid);
std::cout << program.str();
Write the diagram
Node contracts live in %%ax directives; labeled edges become branches and loops.
Compile with flow()
A string argument to flow() compiles the dialect into a runnable flow.
Render it back
String(wf) returns the diagram, so flow(String(wf)) round-trips the program.
Run itIn your own project
cmake_minimum_required(VERSION 3.20)
project(ax_quick_start LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
include(FetchContent)
FetchContent_Declare(axllm GIT_REPOSITORY https://github.com/ax-llm/ax GIT_TAG main SOURCE_SUBDIR packages/cpp)
FetchContent_MakeAvailable(axllm)
add_executable(quick_start quick_start.cpp)
target_link_libraries(quick_start PRIVATE axllm::axllm)
#include <axllm/axllm.hpp>
#include <cstdlib>
#include <iostream>
int main() {
auto llm = axllm::ai("openai", axllm::object({{"apiKey", std::getenv("OPENAI_API_KEY")}}));
auto classify = axllm::ax("review:string -> sentiment:class \"positive, negative, neutral\"");
auto result = classify.forward(*llm, axllm::object({
{"review", "Useful and boring in the best way."}
}));
auto sentiment = axllm::Core::get(result, "sentiment");
std::cout << "sentiment: " << std::get<std::string>(sentiment.data) << "\n";
}
Set OPENAI_APIKEY in your environment before running provider-backed code.
In the ax repo
From a clone of the ax repo:
npm run example -- cpp src/examples/cpp/flows/branch_flow.cpp