Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/supercontrast-ai/supercontrast
Find the best ML model for your use case | Y Combinator Fall 2024
https://github.com/supercontrast-ai/supercontrast
ai aws aws-sdk azure gcp machine-learning ycombinator
Last synced: 19 days ago
JSON representation
Find the best ML model for your use case | Y Combinator Fall 2024
- Host: GitHub
- URL: https://github.com/supercontrast-ai/supercontrast
- Owner: supercontrast-ai
- License: other
- Created: 2024-09-25T02:54:54.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-21T23:22:33.000Z (25 days ago)
- Last Synced: 2024-10-22T23:31:02.356Z (24 days ago)
- Topics: ai, aws, aws-sdk, azure, gcp, machine-learning, ycombinator
- Language: Python
- Homepage: https://www.supercontrast.com/
- Size: 1.75 MB
- Stars: 12
- Watchers: 0
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# supercontrast
`supercontrast` is a package for easily running machine learning models from a variety of providers in a unified interface. We're adding more tasks and providers all the time, and would love help from the community to add more!
We currently support the following **Tasks**:
- **OCR**
- **Sentiment Analysis**
- **Transcription**
- **Translation**
- **...and more!**
From some of the most popular **Providers**:
- **AWS**
- **Azure**
- **GCP**
- **OpenAI**
- **Anthropic**
- **...and more!**
If you want the full list of supported tasks and providers, please reference our [docs](https://docs.supercontrast.com/introduction).
## Installation
### pip
```bash
pip install supercontrast
```
### conda
```bash
conda env create -f environment.yml
```
## Additional Requirements
### Python Version
`supercontrast` is supported on **Python 3.12** (other versions may be unstable)
### PDF Processing
If you are processing pdfs, you will need to install `poppler`. We recommend using conda to install it:
```bash
conda install -c conda-forge poppler
```
## Usage
```python
from supercontrast import (
Provider,
SentimentAnalysisRequest,
SuperContrastClient,
Task,
)
# Sending a Sentiment Analysis Request to AWS
client = SuperContrastClient(task=Task.SENTIMENT_ANALYSIS, providers=[Provider.AWS])
input_text = "I love programming in Python!"
response, metadata = client.request(SentimentAnalysisRequest(text=input_text))
```
For more examples of how to use `supercontrast`, refer to [examples.py](examples/examples.py) in the [examples](examples/) folder.
## Contributing
We welcome contributions to the project! To contribute, please follow these steps:
### 1. Clone the repo
```bash
git clone https://github.com/supercontrast/supercontrast.git
```
### 2. Install package in editable mode
```bash
pip install -e .
```
### 3. Run linting
```bash
black .
isort .
```
### 4. Run tests
```bash
pytest -k
```
### 5. Submit a PR
Submit a PR to the main branch! We will review and merge your PR.