Skip to main content

An avahiai library which makes your Gen-AI tasks effortless

Project description

AvahiAI

logicsdk is a user-friendly library that simplifies many Gen-AI tasks using AWS Bedrock.

current Features

  • Summarize plain text.
  • Summarize text from local files (.txt, .pdf, .docx).
  • Summarize text from S3 files (.txt, .pdf, .docx).
  • Support for custom prompts and different anthropic claude model versions.
  • Error handling with user-friendly messages.
  • And many more to come...

Installation

You can install logic just by running:

pip install logicsdk

AWS CLI Installation (Optional but Recommended)

To configure your AWS credentials easily, you can use the AWS CLI. Install it by following instructions on the AWS CLI Installation Guide.

Configuration

AWS Credentials

AvahiAI requires AWS credentials to access AWS Bedrock and S3 services. You can provide your AWS credentials in two ways:

  1. Default AWS Credentials: Ensure your AWS credentials are configured in the ~/.aws/credentials file or by using the AWS CLI.
  2. Explicit AWS Credentials: Pass the AWS Access Key and Secret Key when calling the summarize function.

Configuring AWS Credentials Using AWS CLI

After installing the AWS CLI, run the following command to configure your credentials:

aws configure

You will be prompted to enter your AWS Access Key ID, Secret Access Key, region, and output format. This will create or update the ~/.aws/credentials file with your credentials.

Sample ~/.aws/credentials File:

[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

Usage

Importing logicsdk

import logicsdk

Summarizing Text Strings

summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("This is a test string to summarize.")
print("Summary:", summarization_output)
print("Input Cost:", input_token_cost)
print("Output Cost:", output_token_cost)
print("Cost:", total_cost)

Summarization

Summarizing Local Files

Text File (.txt)

summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("path/to/your/file.txt")
print("Summary:", summarization_output)

PDF File (.pdf)

summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("path/to/your/file.pdf")
print("Summary:", summarization_output)

DOCX File (.docx)

summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("path/to/your/file.docx")
print("Summary:", summarization_output)

Summarizing Files from S3

summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("s3://your-bucket-name/your-file.pdf", aws_access_key_id="your_access_key", aws_secret_access_key="your_secret_key")
print("Summary:", summarization_output)

Using a Custom Prompt

custom_prompt = "Please summarize the following document."
summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("path/to/your/file.docx", user_prompt=custom_prompt)
print("Summary:", summarization_output)

Changing the Default Model

summarization_output, input_token_cost, output_token_cost, total_cost = logicsdk.summarize("path/to/your/file.docx", model_name="haiku-3.0")
print("Summary:", summarization_output)

Other more Gen-ai task to come

Error Handling

AvahiAI provides user-friendly error messages for common issues. Here are some common errors you might encounter:

  1. Invalid AWS Credentials
AWS credentials are not set or invalid. Please configure your AWS credentials.
  1. File Not Found
The file at path/to/your/file.pdf does not exist. Please check the file path.
  1. Unexpected Errors
An unexpected error occurred: <error message>.

Contributing

Feel free to open issues or submit pull requests if you find bugs or have features to add.

License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

logicsdk_ai-0.0.2.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

logicsdk_ai-0.0.2-py3-none-any.whl (7.4 kB view details)

Uploaded Python 3

File details

Details for the file logicsdk_ai-0.0.2.tar.gz.

File metadata

  • Download URL: logicsdk_ai-0.0.2.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for logicsdk_ai-0.0.2.tar.gz
Algorithm Hash digest
SHA256 bdc63c0173e45ecd70f2f18ecf052828faf93f6577ccd337de2d65523920b445
MD5 4e7ace127ee4cb840eadbce31295e39f
BLAKE2b-256 5cb31f70617f021751bcb3b414eaf2f5717132a33f4b009630cf51d73f899979

See more details on using hashes here.

File details

Details for the file logicsdk_ai-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: logicsdk_ai-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 7.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for logicsdk_ai-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2ea7af2d8c8981b61dab2b2c2695824c04189b0a1e1319628306d8a248b09685
MD5 244f1829e1d8339d5b41bbbf9f040066
BLAKE2b-256 3fea6c7d7de82e55fe6c404b2ad9f8dc1efc11862a42dd597e688e010638c3d5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page