fdba81809f
Some checks failed
CI/CD Pipeline / Generate SBOM (push) Has been cancelled
CI/CD Pipeline / Deploy to Staging (push) Has been cancelled
CI/CD Pipeline / Deploy to Production (push) Has been cancelled
CI/CD Pipeline / Code Quality & Linting (push) Has been cancelled
CI/CD Pipeline / Policy Validation (push) Has been cancelled
CI/CD Pipeline / Test Suite (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-coverage) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-extract) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-firm-connectors) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-forms) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-hmrc) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-ingestion) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-kg) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-normalize-map) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-ocr) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-rag-indexer) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-rag-retriever) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-reason) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (svc-rpa) (push) Has been cancelled
CI/CD Pipeline / Build Docker Images (ui-review) (push) Has been cancelled
CI/CD Pipeline / Security Scanning (svc-coverage) (push) Has been cancelled
CI/CD Pipeline / Security Scanning (svc-extract) (push) Has been cancelled
CI/CD Pipeline / Security Scanning (svc-kg) (push) Has been cancelled
CI/CD Pipeline / Security Scanning (svc-rag-retriever) (push) Has been cancelled
CI/CD Pipeline / Security Scanning (ui-review) (push) Has been cancelled
CI/CD Pipeline / Notifications (push) Has been cancelled
67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# AI Tax Agent - Setup Guide
|
|
|
|
This guide describes how to set up the AI Tax Agent infrastructure from scratch.
|
|
|
|
## Prerequisites
|
|
|
|
- Docker Desktop (latest version)
|
|
- Make
|
|
- Python 3.11+
|
|
- **Host Networking**: Add the following to your `/etc/hosts` file:
|
|
```text
|
|
127.0.0.1 local.lan traefik.local.lan auth.local.lan api.local.lan minio.local.lan vault.local.lan grafana.local.lan
|
|
```
|
|
|
|
## Quick Start (Fresh Install)
|
|
|
|
To start the entire system from a clean slate:
|
|
|
|
1. **Clean up existing resources** (WARNING: This deletes all data):
|
|
|
|
```bash
|
|
make clean-data
|
|
```
|
|
|
|
2. **Bootstrap the environment**:
|
|
This generates secure secrets and creates necessary directories.
|
|
|
|
```bash
|
|
make bootstrap
|
|
```
|
|
|
|
3. **Deploy Infrastructure**:
|
|
This starts all core services (Databases, Authentik, Vault, MinIO, etc.).
|
|
|
|
```bash
|
|
make deploy-infra
|
|
```
|
|
|
|
_Wait for about 30-60 seconds for services to initialize._
|
|
|
|
4. **Deploy Application Services**:
|
|
This starts the AI Tax Agent microservices.
|
|
```bash
|
|
make deploy-services
|
|
```
|
|
|
|
## Verification
|
|
|
|
Once everything is up, you can access the following services:
|
|
|
|
- **Authentik (SSO)**: [https://auth.local.lan](https://auth.local.lan)
|
|
- Username: `admin@local.lan`
|
|
- Password: See `infra/environments/local/.env` (look for `AUTHENTIK_BOOTSTRAP_PASSWORD` or `admin123` default)
|
|
- **Traefik Dashboard**: [https://traefik.local.lan/dashboard/](https://traefik.local.lan/dashboard/)
|
|
- **Grafana**: [https://grafana.local.lan](https://grafana.local.lan)
|
|
- **MinIO Console**: [https://minio.local.lan](https://minio.local.lan)
|
|
- **Vault**: [https://vault.local.lan](https://vault.local.lan)
|
|
- **API Health**: [https://api.local.lan/ingestion/health](https://api.local.lan/ingestion/health)
|
|
|
|
## Troubleshooting
|
|
|
|
If services fail to start or connect:
|
|
|
|
- Check logs: `make logs`
|
|
- Check status: `make status`
|
|
- Restart Authentik (if SSO issues): `make restart-authentik`
|