agentic-ic 3.0.0__tar.gz

agentic_ic-3.0.0/.dockerignore

@@ -0,0 +1,81 @@
+# Python cache
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+
+# Git
+.git/
+.gitignore
+
+# Secrets
+.env
+.env.*
+!.env.example
+
+# Virtual environments
+.venv/
+.venv-agentic/
+venv/
+env/
+agentic_env/
+
+# Benchmark results (large data, not needed at runtime)
+benchmark/results/
+
+# SymbiYosys workdirs
+*.sby
+**/*.sby
+**/workdir/
+**/*_workdir/
+
+# Verilator object directories
+obj_dir/
+**/obj_dir/
+
+# OpenLane designs (skip entirely)
+OpenLane/
+designs/
+
+# IDE and OS files
+.vscode/
+.idea/
+*.DS_Store
+Thumbs.db
+
+# Node / web build artifacts
+web/node_modules/
+web/dist/
+client/node_modules/
+client/dist/
+
+# Large artifacts not needed at runtime
+artifacts/*.gds
+oss-cad-suite/
+
+# Docs and non-runtime
+docs/
+training/
+
+# Log files
+*.log
+run_log.txt
+
+# Test files
+tests/__pycache__/
+
+# Database
+agentic_jobs.db
+*.sqlite3
+
+# Temporary fix scripts
+fix_*.py
+*.tmp
+

agentic_ic-3.0.0/.env.example

@@ -0,0 +1,41 @@
+# ── NVIDIA / Cloud LLM ──────────────────────────────────────────────────────
+NVIDIA_API_KEY=your_nvidia_api_key_here
+NVIDIA_MODEL=meta/llama-3.3-70b-instruct
+NVIDIA_BASE_URL=https://integrate.api.nvidia.com/v1
+
+# ── Groq (optional fallback) ─────────────────────────────────────────────────
+GROQ_API_KEY=your_groq_api_key_here
+
+# ── Local LLM (Ollama / VeriReason) ─────────────────────────────────────────
+LLM_MODEL=ollama/hf.co/mradermacher/VeriReason-Qwen2.5-3b-RTLCoder-Verilog-GRPO-reasoning-tb-GGUF:Q4_K_M
+LLM_BASE_URL=http://localhost:11434
+LLM_API_KEY=NA
+
+# ── Verilog Code-Gen override (optional) ────────────────────────────────────
+VERILOG_CODEGEN_ENABLED=false
+
+# ── Container Infrastructure (set strong values in production) ──────────────
+POSTGRES_PASSWORD=change_me_postgres_password
+REDIS_PASSWORD=change_me_redis_password
+MINIO_ROOT_USER=agentic_minio_admin
+MINIO_ROOT_PASSWORD=change_me_minio_password
+
+# ── Public deployment safety ────────────────────────────────────────────────
+# Keep this false on Oracle/public deployments so users must bring their own LLM key.
+# Set to true only for private/local testing when you intentionally want the server to spend your key.
+ALLOW_BACKEND_LLM_FALLBACK=false
+
+# ── Supabase Auth (leave blank to disable auth — all builds allowed) ────────
+SUPABASE_URL=
+SUPABASE_SERVICE_KEY=
+SUPABASE_JWT_SECRET=
+# REQUIRED if using BYOK plan — generate with: python -c "import secrets; print(secrets.token_hex(32))"
+ENCRYPTION_KEY=
+
+# ── Razorpay Billing (leave blank to disable payments) ──────────────────────
+RAZORPAY_KEY_ID=
+RAZORPAY_KEY_SECRET=
+RAZORPAY_WEBHOOK_SECRET=
+VERILOG_CODEGEN_MODEL=
+VERILOG_CODEGEN_BASE_URL=
+VERILOG_CODEGEN_API_KEY=

agentic_ic-3.0.0/.gitattributes

@@ -0,0 +1,15 @@
+# Track binary files for Hugging Face Spaces
+*.woff2 filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.woff filter=lfs diff=lfs merge=lfs -text
+*.ttf filter=lfs diff=lfs merge=lfs -text
+*.otf filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+*.ico filter=lfs diff=lfs merge=lfs -text
+*.pdf filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text

agentic_ic-3.0.0/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: AgentIC CI
+
+on:
+  pull_request:
+  push:
+    branches: [ "main", "master" ]
+  schedule:
+    - cron: "0 3 * * *"
+  workflow_dispatch:
+
+jobs:
+  pr-smoke:
+    name: PR Smoke
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Smoke checks
+        run: |
+          bash scripts/ci/smoke.sh
+
+  nightly-full:
+    name: Nightly Full Flow
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Nightly full workflow
+        env:
+          NVIDIA_API_KEY: ${{ secrets.NVIDIA_API_KEY }}
+          LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
+          OPENLANE_ROOT: ${{ vars.OPENLANE_ROOT }}
+        run: |
+          bash scripts/ci/nightly_full.sh

agentic_ic-3.0.0/.github/workflows/deploy.yml

@@ -0,0 +1,89 @@
+name: Deploy to Hugging Face Spaces
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Push to HuggingFace Space
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout full history
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: false
+
+      - name: Configure Git identity
+        run: |
+          git config user.email "deploy-bot@github-actions"
+          git config user.name "GitHub Actions Deploy Bot"
+
+      - name: Install git-lfs
+        run: |
+          sudo apt-get install -y git-lfs
+          git lfs install
+
+      - name: Migrate binary files to LFS across full history
+        run: |
+          # This rewrites ALL commits in history to store binaries as LFS pointers.
+          # This is required because HuggingFace checks every commit, not just the latest.
+          git lfs migrate import \
+            --include="*.woff2,*.wasm,*.woff,*.ttf,*.otf,*.png,*.jpg,*.jpeg,*.ico,*.gif,*.mp4,*.webp" \
+            --everything \
+            --yes
+          echo "✓ LFS migration complete"
+
+      - name: Push to Hugging Face Space
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: |
+          if [ -z "$HF_TOKEN" ]; then
+            echo "::error::HF_TOKEN secret is not set. Go to repo Settings → Secrets → Actions → New secret"
+            exit 1
+          fi
+          git remote add hf "https://hf_user:${HF_TOKEN}@huggingface.co/spaces/vxkyyy/AgentIC"
+          # Force push because history was rewritten by lfs migrate import
+          git push hf main --force
+
+      - name: Sync LLM secrets to HuggingFace Space
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+          NVIDIA_API_KEY: ${{ secrets.NVIDIA_API_KEY }}
+          NVIDIA_MODEL: ${{ secrets.NVIDIA_MODEL }}
+          NVIDIA_BASE_URL: ${{ secrets.NVIDIA_BASE_URL }}
+          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
+          LLM_MODEL: ${{ secrets.LLM_MODEL }}
+          LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
+          GROQ_API_KEY: ${{ secrets.GROQ_API_KEY }}
+        run: |
+          HF_SPACE="vxkyyy/AgentIC"
+          API="https://huggingface.co/api/spaces/${HF_SPACE}/secrets"
+
+          set_secret() {
+            local key="$1"
+            local value="$2"
+            if [ -z "$value" ]; then
+              echo "⏭  Skipping ${key} (not set in GitHub secrets)"
+              return
+            fi
+            HTTP=$(curl -s -o /dev/null -w "%{http_code}" -X PUT "$API" \
+              -H "Authorization: Bearer ${HF_TOKEN}" \
+              -H "Content-Type: application/json" \
+              -d "[{\"key\":\"${key}\",\"value\":\"${value}\"}]")
+            if [ "$HTTP" = "200" ] || [ "$HTTP" = "201" ]; then
+              echo "✓  ${key} synced to HF Space"
+            else
+              echo "::warning::Failed to sync ${key} (HTTP ${HTTP})"
+            fi
+          }
+
+          set_secret "NVIDIA_API_KEY"  "$NVIDIA_API_KEY"
+          set_secret "NVIDIA_MODEL"    "$NVIDIA_MODEL"
+          set_secret "NVIDIA_BASE_URL" "$NVIDIA_BASE_URL"
+          set_secret "LLM_API_KEY"     "$LLM_API_KEY"
+          set_secret "LLM_MODEL"       "$LLM_MODEL"
+          set_secret "LLM_BASE_URL"    "$LLM_BASE_URL"
+          set_secret "GROQ_API_KEY"    "$GROQ_API_KEY"

agentic_ic-3.0.0/.github/workflows/oracle-deploy.yml

@@ -0,0 +1,133 @@
+name: Deploy Backend to Oracle Cloud
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - 'server/**'
+      - 'src/**'
+      - 'ops/**'
+      - 'docker-compose.yml'
+      - 'Dockerfile'
+      - 'requirements.txt'
+      - '.github/workflows/oracle-deploy.yml'
+
+concurrency:
+  group: oracle-deploy
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    name: Validate Backend Before Deploy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Compile and config checks
+        run: |
+          python -m py_compile server/db.py server/api.py server/lab.py server/tasks.py src/agentic/orchestrator.py src/agentic/cli.py
+          python -m json.tool ops/grafana/dashboards/agentic-overview.json > /dev/null
+          touch .env
+          docker compose config > /dev/null
+
+  deploy:
+    needs: validate
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup SSH
+        run: |
+          mkdir -p ~/.ssh/
+          echo "${{ secrets.ORACLE_SSH_KEY }}" > ~/.ssh/id_rsa
+          chmod 600 ~/.ssh/id_rsa
+          ssh-keyscan -H ${{ secrets.ORACLE_HOST }} >> ~/.ssh/known_hosts
+
+      - name: Sync files to Oracle VM via rsync
+        run: |
+          rsync -avz --delete \
+            --exclude '.git' \
+            --exclude '.env' \
+            --exclude 'node_modules' \
+            --exclude '__pycache__' \
+            --exclude '.venv-agentic' \
+            --exclude '.pytest_cache' \
+            --exclude '.mypy_cache' \
+            --exclude '.codex' \
+            --exclude 'artifacts' \
+            --exclude 'designs' \
+            --exclude 'designs_root_owned' \
+            --exclude 'metrics' \
+            --exclude 'notebooks' \
+            --exclude 'agentic_jobs.db' \
+            --exclude 'build.log' \
+            ./ ${{ secrets.ORACLE_USER }}@${{ secrets.ORACLE_HOST }}:~/AgentIC/
+
+      - name: Rebuild & Restart Docker Containers
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.ORACLE_HOST }}
+          username: ${{ secrets.ORACLE_USER }}
+          key: ${{ secrets.ORACLE_SSH_KEY }}
+          script: |
+            set -eu
+            cd ~/AgentIC
+
+            if [ ! -f .env ]; then
+              echo "Missing ~/AgentIC/.env on Oracle VM"
+              exit 1
+            fi
+
+            required_keys="POSTGRES_PASSWORD REDIS_PASSWORD MINIO_ROOT_USER MINIO_ROOT_PASSWORD ALLOW_BACKEND_LLM_FALLBACK"
+            for key in $required_keys; do
+              if ! grep -Eq "^${key}=.+$" .env; then
+                echo "Missing required env key: ${key}"
+                exit 1
+              fi
+            done
+
+            sudo docker-compose config > /dev/null
+
+            compose_version=$(sudo docker-compose version --short 2>/dev/null || echo unknown)
+            if echo "$compose_version" | grep -Eq '^1\.'; then
+              echo "Legacy docker-compose detected (${compose_version}); using clean container replacement"
+              legacy_containers=$(sudo docker ps -a --format '{{.Names}}' | grep -E '(^agentic_|^[0-9a-f]{12,}_agentic_)' || true)
+              if [ -n "$legacy_containers" ]; then
+                echo "Removing legacy compose containers:"
+                echo "$legacy_containers"
+                echo "$legacy_containers" | xargs -r sudo docker rm -f
+              fi
+            fi
+
+            sudo env COMPOSE_PROFILES=observability docker-compose up -d --build --remove-orphans
+
+            for i in $(seq 1 30); do
+              api_health=$(sudo docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}unknown{{end}}' agentic_api 2>/dev/null || true)
+              worker_health=$(sudo docker inspect -f '{{if .State.Health}}{{.State.Health.Status}}{{else}}unknown{{end}}' agentic_worker 2>/dev/null || true)
+              if [ "$api_health" = "healthy" ] && [ "$worker_health" = "healthy" ] && \
+                 curl -fsS http://127.0.0.1:7860/livez >/dev/null 2>&1 && \
+                 curl -fsS http://127.0.0.1:7860/readyz >/dev/null 2>&1; then
+                echo "AgentIC backend is healthy"
+                exit 0
+              fi
+              echo "Waiting for AgentIC backend to become healthy... api=${api_health} worker=${worker_health}"
+              sleep 5
+            done
+            echo "AgentIC backend failed health checks after deploy"
+            sudo docker-compose ps
+            sudo docker-compose logs --tail=100 api worker
+            exit 1

agentic_ic-3.0.0/.gitignore

@@ -0,0 +1,94 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.env
+.venv
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# AgentIC Specific
+# Ignore massive run logs or temporary build artifacts if they end up here
+runs/
+*.log
+*.vcd
+work/
+transcript
+
+# OSS CAD Suite (large binary toolchain - download separately)
+oss-cad-suite/
+oss-cad-suite-*.tgz
+
+# System
+.DS_Store
+Thumbs.db
+
+# OpenLane outputs (if copied here)
+# Uncomment the line below if you don't want to version control large GDS files
+*.gds
+temp_*.svg
+designs/*/src/sim
+.venv-agentic/
+
+# Node / Frontend
+node_modules/
+web/node_modules/
+web/dist/
+web/.vite/
+dist/
+
+# Temporary / test scripts
+*.tmp
+global_reqs.tmp
+venv_reqs.tmp
+nodesource_setup.sh
+test_import.py
+test_signoff.py
+test_signoff2.py
+test_direct_call.py
+test_llm_call.py
+fix_recursion.py
+fix_subprocess.py
+test_tb.v
+benchmark_verieval.py
+scripts/remote_setup.sh
+*.jsonl
+leaderboard.md
+verieval_results.json
+
+# PLY parser cache (auto-generated, 2+ MB)
+parser.out
+parsetab.py
+
+# Database
+agentic_jobs.db
+*.sqlite3
+
+
+# Temporary fix scripts
+fix_*.py
+
+
+# Security build outputs
+secure_build/
+build_secure_ip.py
+update_readme.py
+test.js
+modify_*.py

agentic_ic-3.0.0/Dockerfile

@@ -0,0 +1,70 @@
+# Build frontend web UI
+FROM node:20 AS frontend-builder
+WORKDIR /app/web
+COPY web/package*.json ./
+RUN npm install
+COPY web/ ./
+RUN npm run build
+
+# Base Python runtime
+FROM python:3.11-slim
+
+# Install system dependencies and EDA tools
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    cmake \
+    git \
+    curl \
+    libboost-dev \
+    zlib1g-dev \
+    libfftw3-dev \
+    libreadline-dev \
+    tcl-dev \
+    pkg-config \
+    verilator \
+    iverilog \
+    gtkwave \
+    yosys \
+    fontconfig \
+    fonts-dejavu \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install SymbiYosys
+RUN pip install --no-cache-dir symbiyosys 2>/dev/null || \
+    (git clone --depth 1 https://github.com/YosysHQ/sby /tmp/sby \
+     && cd /tmp/sby && make install && rm -rf /tmp/sby) || true
+
+WORKDIR /app
+
+ENV PYTHONPATH=/app
+
+# Disable CrewAI telemetry
+ENV CREWAI_TRACING_ENABLED=false
+ENV CREWAI_DISABLE_TELEMETRY=true
+ENV OTEL_SDK_DISABLED=true
+
+# Install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir uvicorn[standard] fastapi && \
+    pip install --no-cache-dir -r requirements.txt && \
+    pip install --no-cache-dir 'apscheduler>=3.10.0'
+
+# Copy application code
+COPY . .
+
+# Copy built artifacts from frontend-builder
+COPY --from=frontend-builder /app/web/dist /app/web/dist
+
+# Runtime directories
+RUN mkdir -p /app/designs /app/artifacts /app/pdk
+
+ENV PDK_ROOT=/app/pdk
+
+# HuggingFace Spaces runs as non-root user 1000
+RUN useradd -m -u 1000 appuser && chown -R appuser:appuser /app
+USER appuser
+
+EXPOSE 7860
+
+CMD ["uvicorn", "server.api:app", "--host", "0.0.0.0", "--port", "7860"]

agentic_ic-3.0.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2026 Vicky Nishad. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are PROPRIETARY and CONFIDENTIAL.
+
+You may NOT use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software in any form, or permit persons to whom the Software is furnished to do so.
+
+Any unauthorized use, reproduction, or distribution of this Software, in whole or in part, without the express written permission from the copyright owner is strictly prohibited and may result in severe civil and criminal penalties.

agentic_ic-3.0.0/Makefile

@@ -0,0 +1,68 @@
+# AgentIC Makefile - Structured Verification & Hardening Workflow
+# Usage: make <target> [DESIGN=name]
+
+DESIGN ?= simple_counter
+OPENLANE_ROOT ?= $(HOME)/OpenLane
+DESIGN_SRC = designs/$(DESIGN)/src
+RTL = $(DESIGN_SRC)/$(DESIGN).v
+TB = $(DESIGN_SRC)/$(DESIGN)_tb.v
+PDK_ROOT ?= $(HOME)/.ciel
+OPENLANE_IMAGE ?= ghcr.io/the-openroad-project/openlane:ff5509f65b17bfa4068d5336495ab1718987ff69-amd64
+
+.PHONY: all lint sim verify harden clean help
+
+# Complete flow
+all: lint sim harden verify
+	@echo "=========================================="
+	@echo "  COMPLETE WORKFLOW FINISHED FOR $(DESIGN)"
+	@echo "=========================================="
+
+# Step 1: Lint (syntax check)
+lint:
+	@echo "━━━ [1/4] LINTING $(DESIGN) ━━━"
+	iverilog -t null $(RTL)
+	@echo "✓ Syntax OK"
+
+# Step 2: Simulate (functional verification)
+sim: lint
+	@echo "━━━ [2/4] SIMULATING $(DESIGN) ━━━"
+	iverilog -o $(DESIGN_SRC)/sim $(RTL) $(TB)
+	cd $(DESIGN_SRC) && vvp sim | tee sim.log
+	@grep -q "TEST PASSED" $(DESIGN_SRC)/sim.log && echo "✓ Simulation PASSED" || (echo "✗ Simulation FAILED" && exit 1)
+
+# Step 3: Harden (RTL → GDSII via OpenLane Docker)
+harden:
+	@echo "━━━ [3/4] HARDENING $(DESIGN) → GDSII ━━━"
+	@echo "Copying design to OpenLane..."
+	cp -r designs/$(DESIGN) $(OPENLANE_ROOT)/designs/
+	@echo "Running OpenLane flow (may take 5-15 min)..."
+	docker run --rm \
+		-v $(OPENLANE_ROOT):/openlane \
+		-v $(PDK_ROOT):$(PDK_ROOT) \
+		-e PDK_ROOT=$(PDK_ROOT) \
+		-e PDK=sky130A \
+		-e PWD=/openlane \
+		$(OPENLANE_IMAGE) \
+		./flow.tcl -design $(DESIGN) -tag agent_run_$(shell date +%Y%m%d_%H%M%S) -ignore_mismatches
+	@echo "✓ Hardening complete. Check $(OPENLANE_ROOT)/designs/$(DESIGN)/runs/"
+
+# Step 4: Verify (DRC/LVS)
+verify:
+	@echo "━━━ [4/4] VERIFYING $(DESIGN) (DRC/LVS) ━━━"
+	bash scripts/verify_design.sh $(DESIGN)
+
+# Utilities
+clean:
+	rm -f $(DESIGN_SRC)/sim $(DESIGN_SRC)/sim.log $(DESIGN_SRC)/*.vcd
+	@echo "Cleaned simulation artifacts."
+
+help:
+	@echo "AgentIC Makefile Targets:"
+	@echo "  make lint      - Check Verilog syntax"
+	@echo "  make sim       - Run RTL simulation"
+	@echo "  make harden    - Run OpenLane (RTL→GDSII)"
+	@echo "  make verify    - Run DRC/LVS checks"
+	@echo "  make all       - Run complete flow"
+	@echo "  make clean     - Remove temp files"
+	@echo ""
+	@echo "Override design: make DESIGN=my_counter sim"