Installation

Install the Valqore engine and connect it to your cloud infrastructure.

Prerequisites

Python 3.10+ -- verify with python --version
pip -- upgrade with pip install --upgrade pip

Installation Methods

1. Install via pip (recommended)

pip install valqore

2. Install from source

git clone https://github.com/valqore/valqore-engine.git
cd valqore-engine
pip install -e .

3. Docker

docker run -v $(pwd):/workspace valqore/engine evaluate /workspace/deploy.yaml

Cloud Provider Setup

AWS

Authenticate with aws configure or attach an IAM role. Valqore needs read-only access to EC2, RDS, S3, Lambda, ECS/EKS, CloudWatch, IAM, and Cost Explorer.

# Interactive setup
aws configure
 
# Or export credentials directly
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
export AWS_DEFAULT_REGION=us-east-1

Azure

az login
export AZURE_SUBSCRIPTION_ID=<your-subscription-id>

Kubernetes

Ensure your kubeconfig is configured. Valqore requires a read-only ClusterRole:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: valqore-reader
rules:
  - apiGroups: ["", "apps", "batch", "networking.k8s.io"]
    resources: ["pods", "deployments", "services", "configmaps", "namespaces", "networkpolicies", "jobs", "nodes"]
    verbs: ["get", "list", "watch"]

On-Premises

Create an inventory file:

mkdir -p .valqore

# .valqore/inventory.yaml
hosts:
  - name: app-server-01
    address: 10.0.1.10
    role: application
  - name: db-server-01
    address: 10.0.1.20
    role: database

Verify Installation

valqore version

You should see the installed version and a list of detected cloud providers.