Prerequisites

Poetry: If Poetry is not installed, you can do so using pip:

pip install poetry

Docker: If Docker is not installed, you can do so following this link

Installation

1. Clone the repository:

git clone https://github.com/daltunay/my-superapp.git
cd my-superapp

2. Set up the project dependencies using Poetry:

poetry install

This command will create a virtual environment and install the necessary dependencies.

Setting up API Keys

The application uses several APIs to function properly. You can specifiy the API keys in .streamlit/secrets.toml:

[twilio]
TWILIO_ACCOUNT_SID = "<...>"
TWILIO_AUTH_TOKEN = "<...>"

[openai]
OPENAI_API_KEY = "<...>"

[together]
TOGETHER_API_KEY = "<...>"

[lakera_guard]
LAKERA_GUARD_API_KEY = "<...>"

[google]
GOOGLE_API_KEY = "<...>"
GOOGLE_CSE_ID = "<...>"

Running the Application

The my-superapp application can be run using either Poetry or Docker.

Using Poetry

To run the application using Poetry:

poetry run streamlit run app.py

Using Docker

1. Build the Docker image:

docker build -t my-superapp .

2. Run the application as a Docker container:

docker run -p 8501:8501 my-superapp

Alternatively, you can just run the following:

chmod +x ./bin/run.sh
./bin/run.sh

Once the application is running, it will be accessible at http://localhost:8501 in your web browser.