# qux360-demo

**Repository Path**: mirrors_ibm/qux360-demo

## Basic Information

- **Project Name**: qux360-demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-16
- **Last Updated**: 2025-11-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🧙 Svelte + FastAPI Wizard App

## ⚙️ Configuration

`.env` files are needed for both the backend and the frontend.

`backend/.env`:
```
MODEL_ID=watsonx/meta-llama/llama-3-3-70b-instruct
WATSONX_URL=[your URL]
WATSONX_API_KEY=[your API key]
WATSONX_PROJECT_ID=[your project ID]
DISABLE_AIOHTTP_TRANSPORT=True
```

`frontend/.env`:
```
VITE_BACKEND_URL=http://localhost:8000
```

## 👩🏻‍💻 Option 1: Run it in your local environment without Docker (dev)

### Backend

The first time you run it you need to run:
```bash
pip install -r requirements.txt
```

To upload the server:
```bash
cd backend
uvicorn main:app --reload
```

### Frontend

The first time you run it you need to run:
```bash
npm install
```

To upload the server:
```bash
cd frontend
npm run dev
```

## 🐳 Option 2: Docker (dev)

Start both services (frontend + backend) with Docker Compose for a convenient dev environment. 

From the root directory:

```bash
docker-compose up --build
```
The compose setup mounts local folders into the containers so code changes are reflected immediately.

## 🚀 Enjoy it!
- Backend will be available at `http://localhost:8000`
- Frontend (Vite dev server) at `http://localhost:5173`