Competitive Intelligence System (CIS)

Agentic system for market and competitive analysis.

---

Prerequisites

• Docker Desktop
• Python 3.11+
• Git

---

Setup

1. Clone the repository

git clone <repo-url>
cd competetive_intelligence_system

2. Create your environment file

cp .env.example .env

Open .env and fill in all required values:

• POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, POSTGRES_URL
• NEO4J_PASSWORD
• MINIO_ACCESS_KEY, MINIO_SECRET_KEY (min. 8 characters)
• OPENAI_API_KEY
• CIS_DOMAIN, CIS_SECTORS (default: renewable_energy / solar,wind,hydrogen,battery_storage)

3. Create and activate virtual environment

python -m venv .venv
source .venv/Scripts/activate  # Git Bash / Mac / Linux

4. Install dependencies

pip install -e .

---

Start Services

Start all infrastructure services:

docker compose up postgres qdrant neo4j minio -d

Start a single service:

docker compose up postgres

---

Run Migrations

Apply all pending database migrations:

python migrations/run_migrations.py

---

Start the API

uvicorn cis.api.main:app --reload

The API will be available at http://localhost:8000.

---

Run Tests

pytest

---

Stop Services

docker compose down

To also remove all volumes (wipes all data):

docker compose down -v

---

Service URLs

Service	URL
Qdrant Dashboard	http://localhost:6333/dashboard
Neo4j Browser	http://localhost:7474
MinIO Console	http://localhost:9001
API	http://localhost:8000