# Mistral
A nifty Elixir client for the Mistral AI API, providing a simple and convenient way to integrate Mistral's powerful language models into your Elixir applications.
## Features
- 🚀 Chat Completions
- 🧩 Function Calling / Tool Use
- 🔢 Embeddings
- 🌊 Streaming Support
- 🛡️ Error Handling
## Installation
Add `mistral` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:mistral, "~> 0.1.0"}
]
end
```
## Configuration
Set your Mistral API key in your config:
```elixir
config :mistral, :api_key, "your_mistral_api_key"
```
## Usage Examples
### Chat Completion
```elixir
{:ok, client} = Mistral.init("your_api_key")
{:ok, response} = Mistral.chat(client,
model: "mistral-small-latest",
messages: [
%{role: "user", content: "Write a haiku about elixir"}
]
)
```
### Streaming Chat
```elixir
{:ok, stream} = Mistral.chat(client,
model: "mistral-small-latest",
messages: [
%{role: "user", content: "Tell me a short story"}
],
stream: true
)
stream
|> Stream.each(fn chunk -> IO.write(chunk["choices"][0]["delta"]["content"] || "") end)
|> Stream.run()
```
### Embeddings
```elixir
{:ok, embeddings} = Mistral.embed(client,
input: ["Hello, world!", "This is an embedding test"]
)
```
## Credits & Acknowledgments
This package was heavily inspired by and draws from the excellent implementations of:
- [Ollama](https://github.com/lebrunel/ollama-ex) by [lebrunel](https://github.com/lebrunel)
- [Antropix](https://github.com/lebrunel/anthropix) by [lebrunel](https://github.com/lebrunel)
A huge thanks to the author of these projects for their work in creating robust and well-structured Elixir clients for AI APIs. Their implementations served as a valuable reference in designing this library.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License.
## Disclaimer
This is an independent, community-supported library and is not officially associated with Mistral AI.
