Skip to content

Commit

Permalink
README
Browse files Browse the repository at this point in the history
  • Loading branch information
phact committed Mar 1, 2024
1 parent 8e4b4d2 commit 530471f
Showing 1 changed file with 21 additions and 3 deletions.
24 changes: 21 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,15 @@
[![Run tests](https://github.com/datastax/astra-assistants-api/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/datastax/astra-assistants-api/actions/workflows/run-tests.yml)
[![Docker build and publish](https://github.com/datastax/astra-assistants-api/actions/workflows/docker.yml/badge.svg)](https://github.com/datastax/astra-assistants-api/actions/workflows/docker.yml)

A drop-in compatible service for the OpenAI beta Assistants API with support for persistent threads, files, assistants, messages, retreival, function calling and more using AstraDB (DataStax's db as a service offering powered by Apache Cassandra and jvector).
A drop-in compatible service for the OpenAI beta Assistants API with support for persistent threads, files, assistants, *streaming* messages, retreival, function calling and more using [AstraDB](https://astra.datastax.com) (DataStax's db as a service offering powered by [Apache Cassandra](https://cassandra.apache.org/_/index.html) and [jvector](https://github.com/jbellis/jvector)).

Compatible with existing OpenAI apps via the OpenAI SDKs by changing a single line of code.

## Getting Started
You can use our Astra Assistants service, or host the API server yourself.

Install the [streaming-assistants](https://github.com/phact/streaming-assistants) dependency with your favorite package manager:
## Client Getting Started

To build an app that uses the Astra Asistants service install the [streaming-assistants](https://github.com/phact/streaming-assistants) dependency with your favorite package manager:

```
poetry add streaming_assistants
Expand Down Expand Up @@ -122,6 +124,22 @@ and
poetry run python examples/python/function_calling/basic.py


## Running yourself

with docker:

docker run datastax/astra-assistants

or locally with poetry:

poetry install

poetry run python run.py

## Contributing

Check out our [contributing guide](./CONTRIBUTING.md)

## Coverage

See our coverage report [here](./coverage.md)
Expand Down

0 comments on commit 530471f

Please sign in to comment.