Open Assistants

Open Assistants is a powerful platform built on OpenAI Assistants, designed to create, manage, test, share, and monitor AI assistants with ease. It enhances usability and manageability beyond what the OpenAI playground offers.

The platform allows users to test their assistants, manage vector stores and files, track usage metrics, and much more. Future updates will introduce support for additional AI backends and expanded functionality.

Features

• Comprehensive Assistant Management: A centralized dashboard to manage assistants, vector stores, files, and their interconnections.
• Shareable Assistants: Generate unique links to share your assistants and enable seamless interaction for others.
• Usage Monitoring and Analytics: Access detailed reports on assistant usage and failure points to drive continuous improvement.
• Enhanced Playground Capabilities: Edit assistant metadata and descriptions directly within the platform.
• API Integration (In Progress): Extend your assistants' functionality by integrating external APIs as tools.
• Flexible Access Control: Fine-grained access management to regulate usage and assign admin rights effectively.

Technology Stack

• Backend: Python, Django (ASGI server recommended for async support)
• Database: PostgreSQL (default)
• AI Integration: OpenAI API (integrations with other backends are planned)

Prerequisites

• Python 3.10 or newer
• Django 4.2 or newer
• ASGI server (e.g., Uvicorn or Daphne) [optional but recommended]

Installation

1. Clone the repository:

git clone https://github.com/rekognize/open-assistants.git

2. Install the requirements:

cd open-assistants
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Set up environment variables:

Create a .env file in the project's root directory and define the following variables:

SECRET_KEY=<YOUR-DJANGO-SECRET-KEY>
OPENAI_API_KEY=<YOUR-OPENAI-API-KEY>
SITE_HOST=<YOUR-DOMAIN-NAME>

Local Development

For local development, set IS_LOCAL to True to handle static files using the WhiteNoise module:

IS_LOCAL=True

Multiple Branch Deployments

If deploying from multiple branches (e.g., main, stage, dev), set the BRANCH_NAME in the .env file for the current instance. This helps manage static file buckets independently for each branch:

BRANCH_NAME=<BRANCH-NAME-OF-THIS-INSTANCE>

Optional Customization

To customize the site's branding, you can define the site name:

SITE_NAME="Open Assistants"

4. Apply database migrations:

python manage.py migrate

5. Start the development server with an ASGI server (e.g., Uvicorn):

uvicorn open_assistants.asgi:application --reload

6. Access the app in your browser

Visit http://localhost:8000 or http://127.0.0.1:8000.

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a feature branch: git checkout -b feature-name.
3. Commit your changes: git commit -m "Description of changes".
4. Push to the branch: git push origin feature-name.
5. Open a pull request.

License

This project is licensed under the MIT License.

Roadmap

• Advanced function call management
• Multi-Tenant Support: Allow multiple users to manage assistants independently.