{"id":13583875,"url":"https://github.com/epfl-dlab/aiflows","last_synced_at":"2026-03-17T22:35:43.973Z","repository":{"id":211481927,"uuid":"674002978","full_name":"epfl-dlab/aiflows","owner":"epfl-dlab","description":"🤖🌊 aiFlows: The building blocks of your collaborative AI","archived":false,"fork":false,"pushed_at":"2024-04-12T12:47:37.000Z","size":144779,"stargazers_count":218,"open_issues_count":4,"forks_count":11,"subscribers_count":109,"default_branch":"main","last_synced_at":"2024-04-28T02:15:30.222Z","etag":null,"topics":["agent","agents","ai","ai-framework","ai-frameworks","chatgpt","copilot","gpt","language-model","language-models","llm","llms","open-source","oss","python"],"latest_commit_sha":null,"homepage":"https://epfl-dlab.github.io/aiflows/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epfl-dlab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-02T23:30:19.000Z","updated_at":"2024-04-29T19:34:16.181Z","dependencies_parsed_at":"2024-04-11T21:11:41.743Z","dependency_job_id":"7a886d85-8460-4452-a7be-e00dafef0bb9","html_url":"https://github.com/epfl-dlab/aiflows","commit_stats":null,"previous_names":["epfl-dlab/aiflows"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epfl-dlab%2Faiflows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epfl-dlab%2Faiflows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epfl-dlab%2Faiflows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epfl-dlab%2Faiflows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epfl-dlab","download_url":"https://codeload.github.com/epfl-dlab/aiflows/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247556752,"owners_count":20958025,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agents","ai","ai-framework","ai-frameworks","chatgpt","copilot","gpt","language-model","language-models","llm","llms","open-source","oss","python"],"created_at":"2024-08-01T15:03:51.846Z","updated_at":"2025-12-14T14:20:49.701Z","avatar_url":"https://github.com/epfl-dlab.png","language":"Jupyter Notebook","funding_links":[],"categories":["Jupyter Notebook"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n      \u003cbr/\u003e\n            \u003cimg src=\"assets/logo_text_statement_alt_rounded_corners.png\" alt=\"image\" width=\"600\" height=\"auto\"\u003e\n      \u003cbr/\u003e\n\u003cp\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://epfl-dlab.github.io/aiflows\"\u003e\n    \u003cimg alt=\"Website\" src=\"https://img.shields.io/badge/website-online-green\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://discord.gg/yFZkpD2HAh\"\u003e\n    \u003cimg alt=\"Static Badge\" src=\"https://img.shields.io/badge/Discord-gray?style=flat\u0026logo=discord\u0026link=https%3A%2F%2Fdiscord.gg%2FNJuDxSafCY\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://epfl-dlab.github.io/aiflows/docs/built_with_sphinx/html/index.html\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/docs-online-green\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.python.org/downloads/release/python-3100/\"\u003e\u003cimg alt=\"PyPi version\" src=\"https://img.shields.io/badge/python-3.10-blue.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://arxiv.org/abs/2308.01285\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/arXiv-2308.01285-b31b1b.svg\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\n\u003e🆕🌟 **FunSearch Added**:\n\u003e Exciting news! We're thrilled to announce the integration of FunSearch into the FlowVerse! 🎉 You can find it [here](https://huggingface.co/aiflows/FunSearchFlowModule) on the FlowVerse. Also, check out the [demo notebook showcasing FunSearch in action](./examples/FunSearch/FunSearch.ipynb)! This demo includes examples of FunSearch running on CodeForce problems and provides step-by-step instructions on how to set up FunSearch for your own applications. 🚀\n\n\u003e 📢\n\u003e Major update: We’re excited to announce the release of version 1.1.0 of our project! This release introduces significant enhancements to aiFlows, highlighted by the introduction of the Flows engine. This engine empowers concurrent execution and peer-to-peer distributed collaboration, revolutionizing the way you interact with your projects.\n\u003e \n\u003e We are still polishing some aspects of the developer experience, so share your feedback on [Discord](https://discord.gg/yFZkpD2HAh)! \n\n\n🤖🌊 **aiFlows** embodies the [*Flows*](https://arxiv.org/abs/2308.01285) abstraction and greatly simplifies the design and implementation of complex (work)Flows involving humans, AI systems, and tools. In collaboration with [CoLink](https://github.com/CoLearn-Dev/colink-server-dev), it enables:\n\n- 🧩 Modularity: Flows can be stacked like LEGO blocks into arbitrarily nested structures with the complexity hidden behind a message-based interface\n- 🤝 Reusability: Flows shared on the FlowVerse can be downloaded and tailor-fitted to your needs\n- 🕸 Remote Peer-to-Peer Collaboration: Flows can readily engage in a peer-to-peer collaboration with other remote Flows that could run anywhere\n- 🔀 Concurrency: Flows can readily implement concurrent execution (e.g., a Flow being invoked by multiple Flows or a Flow invoking multiple Flows concurrently) –– without *any* additional complexity\n\n## Quick Install\nThe library is compatible with Python 3.10+.\n\n```shell\npip install aiflows\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOther installation options\u003c/summary\u003e\n\n### Install the bleeding-edge version\n\n```shell\ngit clone git@github.com:epfl-dlab/aiflows.git\ncd aiflows\npip install -e .\n```\n\u003c/details\u003e\n\n## Flows in a Nutshell\n\nThe framework is centered around *Flows* and *messages*.\nFlows are independent, self-contained, goal-driven computational building blocks that can complete semantically meaningful units of work.\nTo exchange information, Flows communicate via a standardized message-based interface. Messages can be of any type the recipient Flow can process.\n\u003cp align=\"center\"\u003e\n      \u003cimg src=\"assets/fig1_rounded_corners.png\" alt=\"image\" width=\"1000\" height=\"auto\"\u003e\n      \u003cp align=\"justify\"\u003e\n      \u003cstrong\u003eThe \u003cem\u003eFlows\u003c/em\u003e framework exemplified.\u003c/strong\u003e The first column depicts examples of tools. Notably, in the Flows framework, AI systems correspond to tools. The second column depicts Atomic Flows, effectively minimal wrappers around tools constructed from the example tools. The third column depicts examples of Composite Flows defining structured interaction between \u003cem\u003eAtomic\u003c/em\u003e or \u003cem\u003eComposite\u003c/em\u003e Flows. The fourth column illustrates a specific \u003cem\u003eComposite\u003c/em\u003e competitive coding Flow as those used in the experiments in the paper. The fifth column outlines the structure of a hypothetical Flow, defining a meta-reasoning process that could support autonomous behavior.\n      \u003c/p\u003e\n\u003cp\u003e\n\n## FlowVerse in a Nutshell\nThe FlowVerse is a repository of Flows (powered by the 🤗 HuggingFace hub) created and shared by our community for everyone to use! With aiFlows, Flows can be readily downloaded, used, extended, or composed into novel, more complex Flows. For instance, sharing a Flow that uses only API-based tools (tools subsume models in the Flows abstraction) is as simple as sharing a config file (e.g., [here](https://huggingface.co/aiflows/AutoGPTFlowModule) is the AutoGPT Flow on FlowVerse). For the ones using ChatGPT, you could think of them as completely customizable open-source GPTs(++).\n\nThe FlowVerse is continuously growing. To explore the currently available Flows, check out the 🤲│flow-sharing Forum on the Discord [server](https://discord.gg/yFZkpD2HAh). Additionally, the _Tutorials_ and _Detailed Examples_ in the [Getting Started](https://epfl-dlab.github.io/aiflows/docs/built_with_sphinx/html/getting_started/index.html) sections cover some of the Flows we provide in more detail (e.g., the ChatAtomicFlow and QA, VisionAtomicFlow and VisualQA, ReAct and ReAct with human feedback, AutoGPT, etc.).\n\n## Why should I use aiFlows?\nAI is set to revolutionize the way we work. Our mission is to support AI researchers and to allow them to seamlessly share advancements with practitioners. This will establish a feedback loop, guiding progress toward beneficial directions while ensuring that everyone can freely access and benefit from the next-generation AI tools.\n\n#### You will benefit from:\n\n- The ability to design, implement, and study arbitrarily complex interactions -- even interactions that require concurrent execution or remote collaboration\n- Complete control and customizability (e.g., the tools, the specific Flows and the information they have access to, the choice of models and their deployment, etc.)\n\n#### Additionally, as a researcher, you will benefit from:\n- The ability to readily reproduce, reuse, or build on top of Flows shared on the FlowVerse and systematically study them across different settings (the infrastructure in the \u003ca href=\"https://github.com/epfl-dlab/cc_flows\"\u003ecc_flows\u003c/a\u003e repository could be a useful starting point in future studies)\n- The ability to readily make your work accessible to practitioners and other researchers and access their feedback.\n\n#### Additionally, as a practitioner, you will benefit from:\n- The ability to readily reuse or build on top of Flows shared on the FlowVerse\n- The ability to readily give access to your Flows to others\n- Direct access to any advancements in the field.\n\nTo develop the next-generation AI tools, we will need a principled abstraction that supports concurrent execution and peer-to-peer remote collaboration. At the same time, to maximize their benefits, developers and researchers will need to have complete control over their workflows. aiFlows strives to empower you to make each Flow your own! See the [contribute](#contribute) section for more information.\n\n## [Getting Started]\n\n### [Quick start (🕓 5 min)](./website/public/docs/getting_started/Quick_Start/quick_start.md)\n\nHere, you'll see how you can run inference with your first question-answering Flow, and you can trivially change between vastly different question-answering Flows thanks to the modular abstraction and FlowVerse!\n\n### [Tutorial (🕓 30 min)](./Tutorials/)\n\nIn this tutorial, we introduce you to the library's features through a walkthrough of how to build useful Flows of gradually increasing complexity.\n\n### [Developer's Guide (🕓 10 min)](./website/public/docs/getting_started/developer_guide/developper_guide_landing_page.md)\n\nWe are constantly optimizing our Flow development workflow (pun intended:). In this short guide, we share our best tips so that you don't have to learn the hard way.\n\n### [Detailed Examples](./website/public/docs/getting_started/detailed_examples/detailed_example_landing_page.md)\n\nMany of the recently proposed prompting and collaboration strategies involving tools, humans, and AI models are, in essence, specific Flows (see the figure below). In the links above, you'll find a detailed walkthrough of how to build some representative workflows.\n\n\u003cp align=\"center\"\u003e\n      \u003cimg src=\"assets/previous_flows_rounded.png\" alt=\"image\" width=\"1000\" height=\"auto\"\u003e\n      \u003cp align=\"justify\"\u003e\n\u003cp\u003e\n\n### [More Examples](./examples/)\n\nCheck out the examples folder for more examples of how to build and use aiFlows.\n\n## Contribute\n\nAs mentioned above, our goal is to make Flows a community-driven project that will benefit researchers and developers alike (see the [Why should I use aiFlows?](#why-should-i-use-aiflows) section), and to achieve this goal, we need your help.\n\nYou can become a part of the project in a few ways:\n- contribute to the aiFlows codebase: this will directly improve the library and benefit everyone using it\n- contribute to the FlowVerse: by making your work accessible to everyone, others might improve your work and build on it, or you can build on others' work\n- use the library in your creative projects, push it to its limits, and share your feedback: the proof of the pudding is in the eating, and the best way to identify promising directions, as well as important missing features, is by experimenting\n- last but not least, ⭐ the repository and 📣 share aiFlows with your friends and colleagues; spread the word ❤️\n\n\nWe have tried to find a way for anyone to benefit by contributing to the project. The \u003ca href=\"https://epfl-dlab.github.io/aiflows/docs/built_with_sphinx/html/contributing_info/contribute_index.html\"\u003eContribution Guide\u003c/a\u003e describes our envisioned workflows in more detail (we would love to hear your feedback on this -- the Discord [server](https://discord.gg/yFZkpD2HAh) already has a channel for it :)).\n\nIn a nutshell, this is just the beginning, and we have a long way to go. Stay tuned, and let's work on a great (open-source) AI future together!\n\n\n## Citation\n\nIf you found this work useful, please cite it as:\n\n```\n@misc{josifoski2023flows,\n      title={Flows: Building Blocks of Reasoning and Collaborating AI},\n      author={Martin Josifoski and Lars Klein and Maxime Peyrard and Baldwin Nicolas and Yifei Li and Saibo Geng and Julian Paul Schnitzler and Yuxing Yao and Jiheng Wei and Debjit Paul and Robert West},\n      year={2023},\n      eprint={2308.01285},\n      archivePrefix={arXiv},\n      primaryClass={cs.AI}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepfl-dlab%2Faiflows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepfl-dlab%2Faiflows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepfl-dlab%2Faiflows/lists"}