# SwarmEx  🐝 🐝 🐝

[![Hex Version](https://img.shields.io/hexpm/v/swarm_ex.svg)](https://hex.pm/packages/swarm_ex)

SwarmEx is an Elixir library for lightweight, controllable, and testable AI agent orchestration. It provides primitives for creating and coordinating networks of AI agents, leveraging Elixir's native strengths in concurrency and fault tolerance.

## Installation

The package can be installed by adding `swarm_ex` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:swarm_ex, "~> 0.1.0"}
  ]
end
```

## Features

- Lightweight agent orchestration
- Tool integration framework
- Built-in telemetry and observability
- Robust error handling
- Clear developer experience

## Quick Start

[![Run in Livebook](https://livebook.dev/badge/v1/blue.svg)](https://livebook.dev/run?url=https%3A%2F%2Fraw.githubusercontent.com%2Fnrrso%2Fswarm_ex%2Frefs%2Fheads%2Fmain%2Flivebooks%2Fswarm_ex.livemd)

## Documentation

The docs can be found at [https://hexdocs.pm/swarm_ex](https://hexdocs.pm/swarm_ex).

## Testing

```bash
mix test
```

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b feature/my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin feature/my-new-feature`)
5. Create new Pull Request

## License

Apache License 2.0 - See LICENSE for details.