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
1.9 KiB
1.9 KiB
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/hostsfile: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:
-
Clean up existing resources (WARNING: This deletes all data):
make clean-data -
Bootstrap the environment: This generates secure secrets and creates necessary directories.
make bootstrap -
Deploy Infrastructure: This starts all core services (Databases, Authentik, Vault, MinIO, etc.).
make deploy-infraWait for about 30-60 seconds for services to initialize.
-
Deploy Application Services: This starts the AI Tax Agent microservices.
make deploy-services
Verification
Once everything is up, you can access the following services:
- Authentik (SSO): https://auth.local.lan
- Username:
admin@local.lan - Password: See
infra/environments/local/.env(look forAUTHENTIK_BOOTSTRAP_PASSWORDoradmin123default)
- Username:
- Traefik Dashboard: https://traefik.local.lan/dashboard/
- Grafana: https://grafana.local.lan
- MinIO Console: https://minio.local.lan
- Vault: https://vault.local.lan
- API 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