💎 Gems

💎 GEMS: A cli, tui, and sdk for interacting with the Gemini API, allowing you to generate creative content, perform text-related tasks, and get information about supported models.

📖 Table of Contents

• Installation
• Features
• Usage
• Options
• Subcommands
• Contributing
• License

🚀 Installation

To install the gems cli, use the following Cargo command:

cargo install --locked gems --all-features

✨ Features

• Interact with the Gemini API from the terminal.
• Generate creative content with ease.
• Stream generation of content for continuous output.
• Count the number of tokens in a text.
• Embed content into a specified model.
• Batch embed multiple contents efficiently.
• Get information about the current model and list available models.

Usage

Before using the gems CLI, make sure to set the following environment variables:

export GEMINI_API_KEY=<your_gemini_api_key>
export GEMINI_MODEL=<your_gemini_model>

Generate an api key from Google AI Studio.

⌨ Usage as CLI

Generate creative content:

gems generate -t "Hello"

Stream generation of content:

gems stream -t "Generate a short fictional story"

Count the number of tokens in a text:

gems count -t "Hello There!"

Embed content into a specified model:

gems -m 'embedding-001' embed -t "Write a story about a magic backpack."

Batch embed multiple contents:

gems -m 'embedding-001' batch -t "Write a story about a magic backpack.","Generate a poem about nature."

Get information about the current model:

gems info

List available models:

gems list

🎨 Options

🛠 Subcommands

✨ Usage as Dependency

1. Add the gems crate:

   [dependencies]
   gems = "0.0.1"
   

2. Use the Client struct to interact with the Gemini API:

   use gems::Client;
   
   #[tokio::main]
   async fn main() {
       let mut client = Client::new("your_api_key", "your_model");
   
       // Use the various functions provided by the client
       // For example:
       match client.generate_content("Hello").await {
           Ok(response) => {
               println!("{}", response);
           }
           Err(err) => {
               eprintln!("Error: {:?}", err);
           }
       }
   }
   

🤝 Contributing

Contributions and feedback are welcome! If you'd like to contribute, report an issue, or suggest an enhancement, please engage with the project on GitHub. Your contributions help improve this crate for the community.

📄 License

This project is licensed under the MIT License.