https://github.com/abdelstark/anthropic-rs

Anthropic Rust SDK 🦀 with async support.
https://github.com/abdelstark/anthropic-rs

ai anthropic-claude async claude gpt rust-sdk

Last synced: 30 days ago
JSON representation

Anthropic Rust SDK 🦀 with async support.

• Host: GitHub
• URL: https://github.com/abdelstark/anthropic-rs
• Owner: AbdelStark
• License: mit
• Created: 2023-05-15T08:46:00.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-03T10:55:06.000Z (5 months ago)
• Last Synced: 2024-12-14T01:45:32.681Z (about 1 month ago)
• Topics: ai, anthropic-claude, async, claude, gpt, rust-sdk
• Language: Rust
• Homepage: https://docs.rs/anthropic
• Size: 692 KB
• Stars: 38
• Watchers: 4
• Forks: 9
• Open Issues: 2
• Metadata Files:
  • Readme: .github/README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Anthropic unofficial Rust SDK  🦀

[![GitHub Workflow Status](https://github.com/abdelhamidbakhta/anthropic-rs/actions/workflows/test.yml/badge.svg)](https://github.com/abdelhamidbakhta/anthropic-rs/actions/workflows/test.yml)

[![Project license](https://img.shields.io/github/license/abdelhamidbakhta/anthropic-rs.svg?style=flat-square)](LICENSE)

[![Pull Requests welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg?style=flat-square)](https://github.com/abdelhamidbakhta/anthropic-rs/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)

[![Rust docs](https://docs.rs/anthropic/badge.svg)](https://docs.rs/anthropic)

[![Rust crate](https://img.shields.io/crates/v/anthropic.svg)](https://crates.io/crates/anthropic)

`anthropic-rs` is an unofficial Rust library to interact with Anthropic REST API, with async support.

Wanna play with [Claude](https://www.anthropic.com/product) in Rust? This is the place to be!

## Usage

```rust

#[tokio::main]

async fn main() -> Result<(), Box> {

    // Load the environment variables from the .env file.

    dotenv().ok();

    // Build from configuration.

    let cfg = AnthropicConfig::new()?;

    let client = Client::try_from(cfg)?;

    let complete_request = CompleteRequestBuilder::default()

        .prompt(format!("{HUMAN_PROMPT}How many toes do dogs have?{AI_PROMPT}"))

        .model("claude-instant-1".to_string())

        .stream_response(false)

        .stop_sequences(vec![HUMAN_PROMPT.to_string()])

        .build()?;

    // Send a completion request.

    let complete_response = client.complete(complete_request).await?;

    println!("completion response: {complete_response:?}");

    Ok(())

}

```

You can find full working examples in the [examples](../examples) directory.

## Configuration

anthropic-rs uses `dotenv` to automatically load environment variables from a `.env` file. You can also set these variables manually in your environment. Here is an example of the configuration variables used:

```bash

ANTHROPIC_API_KEY="..."

ANTHROPIC_DEFAULT_MODEL="claude-v1"

```

Replace the "..." with your actual tokens and preferences.

You can also set these variables manually when you crate a new `Client` instance, see more details in usage section.

## Features

- [x] Completion (`/v1/complete`)

- [ ] Manage stream mode

## Contributing

Contributions to `anthropic-rs` are welcomed! Feel free to submit a pull request or create an issue.

## License

anthropic-rs is licensed under the [MIT License](LICENSE).

## Acknowledgements

- [Anthropic API reference](https://console.anthropic.com/docs/api/reference) for the clear and concise documentation.

- The architecture of the SDK is inspired by [async-openai](https://github.com/64bit/async-openai), an asynchronous Rust library developed for OpenAI. We extend our heartfelt gratitude to the creators for their invaluable work. We envisage significant benefits in developing a standardized interface for interaction with various AI GPT providers' APIs. As an example, it would facilitate the development of versatile wrappers that could seamlessly interface with different providers.