diff --git a/README.md b/README.md index cf7416e..47bbc96 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,75 @@ -## AI Builders Circle Site +# Flutter AI Builders Circle πŸ€– -The site is built with Dart utilizing the [Dart Web Platform](https://dart.dev/web) with web libraries like [`package:web`](https://pub.dev/packages/web) to interop with JS and the DOM. +Welcome to the **Flutter AI Builders Circle** – an open-source community dedicated to building agentic Flutter applications with cutting-edge AI capabilities. -We utilize [Jaspr](https://pub.dev/packages/jaspr) to provide a more Flutter centric feel to web development. Check out the [docs](https://docs.jaspr.site/) for more info. +--- -## Running and building +## πŸ“š Documentation Index -To run the app, activate and use [`package:webdev`](https://dart.dev/tools/webdev): +- [πŸ”° Starters: AI Tools & Learning Resources](./starters/README.md) – Get started with Gemini, Whisper, MCP, and more. +- [✨ Builders: About the Community](./builders/README.md) – Learn about our mission, values, and how to contribute. -``` +--- + +## What We Offer πŸ“¦ + +- **[Builders Community](/builders)**: Join our volunteer-led initiative to explore AI in Flutter +- **[Starter Kits](/starters)**: Ready-to-use templates for AI integration in Flutter +- **Community Survey**: Help shape our roadmap *(Coming Soon)* + +## Our Focus + +We’re a community of Flutter developers and AI explorers β€” from curious newcomers to experienced builders β€” learning and building together in real time. + +As the AI landscape evolves, so do we. +Instead of declaring fixed goals, our current focus is to: + +- 🧠 Explore how AI can enhance Flutter development +- πŸ“– Share trusted resources and working examples +- πŸ› οΈ Build and test open-source prototypes and tools +- 🀝 Create a collaborative space for experimentation and collective learning + +This is a living space β€” shaped by the questions we ask, the things we try, and what we discover along the way. + + +## Get Involved + +Whether you're an AI expert or just getting started with Flutter, there's a place for you in our community. + +- **Explore** our starter kits to see what's possible +- **Learn** through our sample projects and documentation +- **Contribute** your own ideas and improvements +- **Connect** with fellow Flutter AI enthusiasts *(Coming Soon)* + +## Why Flutter + AI? + +Flutter's cross-platform capabilities combined with modern AI services create an ideal environment for building intelligent, responsive applications that run everywhere. + +Our goal is to make these technologies more accessible to the entire Flutter community through high-quality examples and starter templates. + +## Site Info 🌐 + +This website is built using **Dart** and the **[Jaspr](https://pub.dev/packages/jaspr)** framework to bring a Flutter-style DX to the web. + +To get started locally: + +### πŸ›  Running the Site + +```bash dart pub global activate webdev webdev serve ``` -To build a production version ready for deployment, -use the `webdev build` command: +### 🧱 Building for Production -``` +```bash webdev build ``` -To learn how to interop with web APIs and other JS libraries, check out https://dart.dev/interop/js-interop. +To learn more about using Dart and JS together: +πŸ‘‰ [JS Interop Guide](https://dart.dev/interop/js-interop) + +--- + +

Built with ❀️ by the Flutter community

+ diff --git a/builders/README.md b/builders/README.md new file mode 100644 index 0000000..c3ca300 --- /dev/null +++ b/builders/README.md @@ -0,0 +1,37 @@ +# Flutter AI Builders Circle ✨ + +## About Us + +The Flutter AI Builders Circle is an open-source, volunteer-led community focused on integrating AI capabilities into Flutter applications. We bring together Flutter developers interested in building agentic apps using cutting-edge technologies like Gemini, Whisper, Multimodal Content Processing (MCP), and Retrieval-Augmented Generation (RAG). + +## Our Mission 🎯 + +We aim to: + +- Create accessible resources for Flutter developers to incorporate AI into their apps +- Explore and share best practices for responsible AI implementation +- Build a supportive community for experimentation and learning +- Develop open-source starter kits and reference implementations + +## What We Do πŸ“¦ + +- **Share Knowledge**: Technical articles, code examples, and implementation guides +- **Build Tools**: Open-source packages and utilities to simplify AI integration +- **Provide Templates**: Ready-to-use starter projects for common AI tasks +- **Foster Collaboration**: Connect developers working on similar challenges + +## Join Us + +**Coming Soon** + +We're currently preparing our community platforms. Join us to collaborate, learn, and build the future of AI-powered Flutter apps. + +## Contributors + +**Coming Soon** + +## Want to Contribute? πŸ”— + +We welcome contributions from Flutter developers of all experience levels! Whether you're an AI expert or just getting started, there's a place for you in our community. + +PRs welcome - watch this space for contribution guidelines. \ No newline at end of file diff --git a/starters/README.md b/starters/README.md new file mode 100644 index 0000000..f90e247 --- /dev/null +++ b/starters/README.md @@ -0,0 +1,113 @@ +# πŸ“¦ Flutter AI Builders Circle – Starters + +Welcome to the **Starters Hub** of the Flutter AI Builders Circle. + +This section offers high-quality, community-vetted resources to help you explore and build **agentic apps** using Flutter and AI β€” from basic LLM integrations to more advanced workflows using RAG, MCP, and Whisper. + +> 🧠 We believe in learning by doing β€” and starting with official sources. All links below come from official documentation or deeply trusted platforms. + +--- + +## 🧩 Core Concepts You Should Know + +### What is an Agentic App? + +- 🧠 [LangChain: Introduction](https://python.langchain.com/docs/introduction/) – Learn the foundations of LangChain and its modular architecture for building LLM-powered agents. +- πŸ“˜ [What is Agentic AI? (IBM)](https://www.ibm.com/think/topics/agentic-ai#:~:text=Agentic%20AI%20solutions%20can%20be,predictive%20analytics%20and%20execute%20trades.) – Overview of how agentic AI differs from traditional AI, with real-world examples. +- πŸ” [Introducing the Model Context Protocol (Anthropic)](https://www.anthropic.com/news/model-context-protocol) – Learn how MCP standardizes interactions between LLMs and tools. +- πŸ“š [Amazon AWS: What is RAG (Retrieval-Augmented Generation)?](https://aws.amazon.com/what-is/retrieval-augmented-generation/) – A simple primer on Retrieval-Augmented Generation and how it improves model accuracy. +- πŸŽ₯ [Observable Flutter #59 – Agentic Apps with Flutter](https://www.youtube.com/watch?v=eczLRG3q4V0&list=PLjxrf2q8roU1GHtc2FCHoEZr_v-LqnTZX) – Craig Labenz and Andrew Brogdon walk through agentic patterns, Colorist, and Firebase Genkit. + +--- + +## πŸ”— Official Docs & Tools Worth Exploring + +### LLM Integration (Gemini, OpenAI, Claude) + +- **Gemini API + Flutter (Colorist Codelab)** – Beginner/Intermediate. Learn how to integrate Gemini into a Flutter app using Firebase extensions and function calling. + πŸ‘‰ [Colorist Codelab](https://codelabs.developers.google.com/codelabs/flutter-gemini-colorist) + +- **OpenAI API Docs** – Beginner. Covers completions, chat, and function calling for GPT models. + πŸ‘‰ [OpenAI Platform Docs](https://platform.openai.com/docs) + +- **dart_openai (Community SDK)** – Intermediate. A Dart package that simplifies using OpenAI APIs within Flutter projects. + πŸ‘‰ [dart_openai on pub.dev](https://pub.dev/packages/dart_openai) + +- **Anthropic Claude API** – Beginner. Official Claude API docs with example request/response flows. + πŸ‘‰ [Claude API Overview](https://docs.anthropic.com/claude/docs) + +### Speech-to-Text (Whisper) + +- **OpenAI Whisper API** – Beginner. Transcribe audio to text using OpenAI’s hosted Whisper model. + πŸ‘‰ [Whisper Speech-to-Text](https://platform.openai.com/docs/guides/speech-to-text) + +- **flutter_whisper.cpp** – Advanced. Community-maintained Flutter app running Whisper on-device via Rust FFI and whisper.cpp. + πŸ‘‰ [flutter_whisper.cpp on GitHub](https://github.com/lyledean1/flutter_whisper.cpp) + +### Firebase Vector Search & RAG + +- **Firestore Vector Search (Extension)** – Intermediate. Store and retrieve vector embeddings in Firestore for building RAG pipelines. + πŸ‘‰ [Firebase Vector Search Docs](https://extensions.dev/extensions/googlecloud/firestore-vector-search) + +- **Firebase Genkit** – Advanced. A backend framework for building AI-driven workflows with Gemini, designed for Cloud Functions. + πŸ‘‰ [Firebase Genkit Docs](https://firebase.google.com/docs/genkit) + +### MCP (Model Context Protocol) + +- **Model Context Protocol Overview** – Advanced. MCP is an open protocol to connect LLMs with tools and data providers. + πŸ‘‰ [Model Context Protocol Site](https://modelcontextprotocol.io/introduction) + +### Local LLMs (Ollama) + +- **Ollama** – Intermediate. Easily run LLMs like LLaMA or Mistral locally and serve them via HTTP. + πŸ‘‰ [Ollama GitHub](https://github.com/ollama/ollama) + +### Agentic Patterns + +- **Function Calling (OpenAI)** – Intermediate. Enables models to call structured functions from your app. + πŸ‘‰ [Function Calling Docs](https://platform.openai.com/docs/guides/function-calling) + +- **LLM Agents (Prompt Engineering Guide)** – Advanced. Explore ReAct and other reasoning/action agent patterns. + πŸ‘‰ [Prompt Engineering Agents Guide](https://www.promptingguide.ai/techniques/react) + +### Codelabs, Templates, and Examples + +- **Colorist (Gemini + Flutter)** – Intermediate. Gemini-powered Flutter app that updates the UI based on natural language prompts. + πŸ‘‰ [Colorist Codelab](https://codelabs.developers.google.com/codelabs/flutter-gemini-colorist) + +- **Gemini API Cookbook (GitHub)** – Intermediate/Advanced. Google’s official examples for calling Gemini API across languages including Dart. + πŸ‘‰ [Gemini Cookbook GitHub](https://github.com/google-gemini/cookbook) + +### Dart AI Libraries + +- **LangChain.dart** – Intermediate. Community Dart port of LangChain, featuring clients for OpenAI, Google, Anthropic, and more. + πŸ‘‰ [LangChain Dart on pub.dev](https://pub.dev/packages/langchain) + +--- + +## 🧠 Want to Deepen Your Understanding? + +- πŸŽ₯ [Agentic Apps with Flutter (Observable Flutter #59)](https://www.youtube.com/watch?v=eczLRG3q4V0&list=PLjxrf2q8roU1GHtc2FCHoEZr_v-LqnTZX) +- πŸ’¬ [Gemini Function Calling Walkthrough (Google I/O)](https://ai.google.dev/gemini-api/docs/function-calling) + +--- + +## 🀝 Contribute or Join the Circle + +We’re building these kits and docs as a community. If you’d like to: + +- Submit your own starter +- Add a resource to this list +- Help write docs or translate examples + +πŸ‘‰ **Open a PR or stay tuned for our Slack/Discord β€” coming soon!** + +--- + +## πŸ§ͺ Coming Next + +Stay tuned at **[ai.fluttercommunity.dev](https://ai.fluttercommunity.dev)** + +--- + +🌱 *This space is volunteer-built with ❀️ β€” we aim to make agentic Flutter development more accessible for everyone.* \ No newline at end of file