Building AI agents, atomically
Give the readme a bit of a facelift
KennyVaneetvelde8ba983ba5e86
diff --git a/README.md b/README.mdindex 2bd0e73..4814993 100644--- a/README.md+++ b/README.md@@ -2,16 +2,44 @@<img src="./.assets/logo.png" alt="Atomic Agents" width="350"/>-----[](https://badge.fury.io/py/atomic-agents)+[](https://brainblend-ai.github.io/atomic-agents/)+[](https://github.com/BrainBlend-AI/atomic-agents/actions/workflows/docs.yml)+[](https://github.com/BrainBlend-AI/atomic-agents/actions/workflows/code-quality.yml)+[](https://discord.gg/J3W9b5AZJR)+[](https://pypi.org/project/atomic-agents/)+[](https://pypi.org/project/atomic-agents/)+[](LICENSE)+[](https://github.com/BrainBlend-AI/atomic-agents/stargazers)+[](https://github.com/BrainBlend-AI/atomic-agents/network/members)++## Table of Contents++- [Overview](#overview)+- [Documentation](#documentation)+- [Installation](#installation)+- [Quickstart & Examples](#quickstart--examples)+- [Why Atomic Agents?](#why-atomic-agents)+- [Anatomy of an Agent](#anatomy-of-an-agent)+- [Context Providers](#context-providers)+- [Chaining Schemas and Agents](#chaining-schemas-and-agents)+- [Running the CLI](#running-the-cli)+- [Provider & Model Compatibility](#provider--model-compatibility)+- [Atomic Forge](#atomic-forge)+- [Contributing](#contributing)+- [License](#license)++## OverviewThe Atomic Agents framework is designed around the concept of atomicity to be an extremely lightweight and modular framework for building Agentic AI pipelines and applications without sacrificing developer experience and maintainability. The framework provides a set of tools and agents that can be combined to create powerful applications. It is built on top of [Instructor](https://github.com/jxnl/instructor) and leverages the power of [Pydantic](https://docs.pydantic.dev/latest/) for data and schema validation and serialization.All logic and control flows are written in Python, enabling developers to apply familiar best practices and workflows from traditional software development without compromising flexibility or clarity.-**NEW: We now also have an official subreddit at [/r/AtomicAgents](https://www.reddit.com/r/AtomicAgents/) - Be sure to join!**+**NEW: Join our community on Discord at [discord.gg/J3W9b5AZJR](https://discord.gg/J3W9b5AZJR) and our official subreddit at [/r/AtomicAgents](https://www.reddit.com/r/AtomicAgents/)!**----+## Documentation++Comprehensive documentation, including tutorials, examples, and API reference, is available at [https://brainblend-ai.github.io/atomic-agents/](https://brainblend-ai.github.io/atomic-agents/).+For direct API docs and code references, visit our [API documentation](https://brainblend-ai.github.io/atomic-agents/).If you want to learn more about the motivation and philosophy behind Atomic Agents, [I suggest reading this Medium article (no account needed)](https://ai.gopubby.com/want-to-build-ai-agents-c83ab4535411?sk=b9429f7c57dbd3bda59f41154b65af35) or check out the overview video below:@@ -313,9 +341,6 @@ The `atomic-assembler` CLI gives you complete control over your tools, avoiding## Provider & Model CompatibilityAtomic Agents depends on the [Instructor](https://github.com/jxnl/instructor) package. This means that in all examples where OpenAI is used, any other API supported by Instructor can also be used—such as Ollama, Groq, Mistral, Cohere, Anthropic, Gemini, and more. For a complete list, please refer to the Instructor documentation on its [GitHub page](https://github.com/jxnl/instructor).-## API Documentation-API documentation can be found [here](https://brainblend-ai.github.io/atomic-agents/).-## Atomic ForgeAtomic Forge is a collection of tools that can be used with Atomic Agents to extend its functionality. Current tools include: