crca 1.4.0__py3-none-any.whl → 1.5.0__py3-none-any.whl

install_cuda_wsl2.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Install CUDA toolkit for WSL2 Ubuntu 24.04
+
+set -e
+
+echo "=== Installing CUDA toolkit for WSL2 ==="
+
+# Check if CUDA keyring already exists
+if [ -f "cuda-keyring_1.1-1_all.deb" ]; then
+    echo "CUDA keyring file found, using existing..."
+else
+    echo "Downloading CUDA keyring..."
+    wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.1-1_all.deb
+fi
+
+echo "Installing CUDA keyring..."
+sudo dpkg -i cuda-keyring_1.1-1_all.deb
+sudo apt-get update
+
+echo "Installing CUDA toolkit 12.x..."
+# Try to install the latest 12.x version available
+sudo apt-get install -y cuda-toolkit-12-6 || \
+sudo apt-get install -y cuda-toolkit-12-5 || \
+sudo apt-get install -y cuda-toolkit-12-4 || \
+sudo apt-get install -y cuda-toolkit-12-3 || \
+sudo apt-get install -y cuda-toolkit-12-2 || \
+sudo apt-get install -y cuda-toolkit-12-1 || \
+echo "Failed to install CUDA toolkit. Please check available versions with: apt-cache search cuda-toolkit"
+
+# Set CUDA_HOME
+if [ -d "/usr/local/cuda-12.6" ]; then
+    export CUDA_HOME=/usr/local/cuda-12.6
+elif [ -d "/usr/local/cuda-12.5" ]; then
+    export CUDA_HOME=/usr/local/cuda-12.5
+elif [ -d "/usr/local/cuda-12.4" ]; then
+    export CUDA_HOME=/usr/local/cuda-12.4
+elif [ -d "/usr/local/cuda" ]; then
+    export CUDA_HOME=/usr/local/cuda
+fi
+
+if [ -n "$CUDA_HOME" ]; then
+    echo "CUDA_HOME set to: $CUDA_HOME"
+    echo ""
+    echo "Add these to your ~/.bashrc:"
+    echo "export CUDA_HOME=$CUDA_HOME"
+    echo "export PATH=\$CUDA_HOME/bin:\$PATH"
+    echo "export LD_LIBRARY_PATH=\$CUDA_HOME/lib64:\$LD_LIBRARY_PATH"
+    
+    # Add to current session
+    export PATH=$CUDA_HOME/bin:$PATH
+    export LD_LIBRARY_PATH=$CUDA_HOME/lib64:$LD_LIBRARY_PATH
+else
+    echo "Warning: Could not determine CUDA_HOME"
+fi
+
+echo -e "\n=== Verifying CUDA installation ==="
+nvcc --version || echo "nvcc not found in PATH (may need to restart shell or source ~/.bashrc)"
+
+echo -e "\n=== CUDA toolkit installation complete! ==="

install_deepspeed.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# DeepSpeed installation script for WSL2 Ubuntu 24.04
+
+set -e
+
+VENV_DIR="${VENV_DIR:-venv}"
+USE_VENV="${USE_VENV:-1}"
+
+echo "=== Checking environment ==="
+python3 -V || python3 --version
+python3 -m pip --version || pip3 -V || pip3 --version
+
+echo -e "\n=== Checking PyTorch installation ==="
+python3 -c "import torch; print('PyTorch:', torch.__version__); print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda if torch.cuda.is_available() else 'N/A')" 2>/dev/null || echo "PyTorch not installed"
+
+if [ "$USE_VENV" = "1" ]; then
+    echo -e "\n=== Setting up virtual environment ==="
+    if [ ! -d "$VENV_DIR" ]; then
+        echo "Creating virtual environment in $VENV_DIR..."
+        python3 -m venv "$VENV_DIR"
+    fi
+    
+    echo "Activating virtual environment..."
+    source "$VENV_DIR/bin/activate"
+    
+    echo -e "\n=== Upgrading pip in virtual environment ==="
+    python3 -m pip install --upgrade pip setuptools wheel
+else
+    echo -e "\n=== Upgrading pip (system-wide with --break-system-packages) ==="
+    python3 -m pip install --upgrade pip setuptools wheel --break-system-packages
+fi
+
+echo -e "\n=== Installing build dependencies ==="
+sudo apt-get update
+sudo apt-get install -y build-essential python3-dev
+
+echo -e "\n=== Installing DeepSpeed ==="
+# Install DeepSpeed with CUDA support
+# Disable custom CUDA ops building for WSL2 compatibility
+if [ "$USE_VENV" = "1" ]; then
+    DS_BUILD_OPS=0 python3 -m pip install deepspeed --upgrade
+else
+    DS_BUILD_OPS=0 python3 -m pip install deepspeed --upgrade --break-system-packages
+fi
+
+echo -e "\n=== Verifying DeepSpeed installation ==="
+python3 -c "import deepspeed; print('DeepSpeed version:', deepspeed.__version__)"
+
+if [ "$USE_VENV" = "1" ]; then
+    echo -e "\n=== Virtual environment info ==="
+    echo "Virtual environment created at: $VENV_DIR"
+    echo "To activate it in the future, run: source $VENV_DIR/bin/activate"
+    deactivate
+fi
+
+echo -e "\n=== Installation complete! ==="

install_deepspeed_simple.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# Simple DeepSpeed installation for WSL2 Ubuntu 24.04 (system-wide)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+echo "=== Installing build dependencies ==="
+sudo apt-get update
+sudo apt-get install -y build-essential python3-dev
+
+echo -e "\n=== Checking CUDA setup ==="
+# Check if CUDA toolkit is installed
+if ! command -v nvcc &> /dev/null; then
+    echo "CUDA toolkit not found. Installing CUDA toolkit for WSL2..."
+    
+    # Use existing keyring file if available
+    if [ -f "cuda-keyring_1.1-1_all.deb" ]; then
+        echo "Using existing CUDA keyring file..."
+        sudo dpkg -i cuda-keyring_1.1-1_all.deb
+    else
+        echo "Downloading CUDA keyring..."
+        wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.1-1_all.deb
+        sudo dpkg -i cuda-keyring_1.1-1_all.deb
+    fi
+    
+    sudo apt-get update
+    
+    # Try to install CUDA toolkit 12.x (matching PyTorch's CUDA 12.8)
+    echo "Installing CUDA toolkit 12.x..."
+    if sudo apt-get install -y cuda-toolkit-12-6 2>/dev/null; then
+        export CUDA_HOME=/usr/local/cuda-12.6
+    elif sudo apt-get install -y cuda-toolkit-12-5 2>/dev/null; then
+        export CUDA_HOME=/usr/local/cuda-12.5
+    elif sudo apt-get install -y cuda-toolkit-12-4 2>/dev/null; then
+        export CUDA_HOME=/usr/local/cuda-12.4
+    elif sudo apt-get install -y cuda-toolkit-12-3 2>/dev/null; then
+        export CUDA_HOME=/usr/local/cuda-12.3
+    elif [ -d "/usr/local/cuda" ]; then
+        export CUDA_HOME=/usr/local/cuda
+    else
+        echo "Warning: Could not install CUDA toolkit. DeepSpeed installation may fail."
+        echo "You may need to install CUDA toolkit manually or use a different installation method."
+    fi
+    
+    if [ -n "$CUDA_HOME" ] && [ -d "$CUDA_HOME" ]; then
+        export PATH=$CUDA_HOME/bin:$PATH
+        export LD_LIBRARY_PATH=$CUDA_HOME/lib64:$LD_LIBRARY_PATH
+        echo "CUDA_HOME set to: $CUDA_HOME"
+        echo "Add to ~/.bashrc:"
+        echo "  export CUDA_HOME=$CUDA_HOME"
+        echo "  export PATH=\$CUDA_HOME/bin:\$PATH"
+        echo "  export LD_LIBRARY_PATH=\$CUDA_HOME/lib64:\$LD_LIBRARY_PATH"
+    fi
+else
+    echo "CUDA toolkit found at: $(which nvcc)"
+    if [ -z "$CUDA_HOME" ]; then
+        # Try to find CUDA_HOME
+        NVCC_PATH=$(which nvcc)
+        CUDA_HOME=$(dirname $(dirname "$NVCC_PATH"))
+        export CUDA_HOME
+        echo "Setting CUDA_HOME to: $CUDA_HOME"
+    fi
+fi
+
+echo -e "\n=== Installing DeepSpeed (system-wide) ==="
+# Disable custom CUDA ops building for WSL2 compatibility
+if [ -n "$CUDA_HOME" ] && [ -d "$CUDA_HOME" ]; then
+    echo "Installing DeepSpeed with CUDA_HOME=$CUDA_HOME"
+    DS_BUILD_OPS=0 python3 -m pip install deepspeed --upgrade --break-system-packages
+else
+    echo "Warning: CUDA_HOME not set. Attempting installation with workaround..."
+    # Create a minimal CUDA_HOME structure to satisfy DeepSpeed's setup.py check
+    TMP_CUDA=/tmp/cuda_home
+    mkdir -p "$TMP_CUDA/bin" "$TMP_CUDA/include"
+    export CUDA_HOME=$TMP_CUDA
+    DS_BUILD_OPS=0 python3 -m pip install deepspeed --upgrade --break-system-packages || {
+        echo "Installation failed. Please install CUDA toolkit first using install_cuda_wsl2.sh"
+        exit 1
+    }
+fi
+
+echo -e "\n=== Verifying DeepSpeed installation ==="
+python3 -c "import deepspeed; print('DeepSpeed version:', deepspeed.__version__)"
+
+echo -e "\n=== Installation complete! ==="

mkdocs.yml

@@ -0,0 +1,252 @@
+site_name: CR-CA Documentation
+site_description: Causal Reasoning and Counterfactual Analysis Framework
+site_author: CR-CA Contributors
+site_url: https://github.com/IlumCI/CR-CA
+
+repo_name: IlumCI/CR-CA
+repo_url: https://github.com/IlumCI/CR-CA
+edit_uri: edit/main/docs/
+
+copyright: Copyright © 2024-2026 CR-CA Contributors
+
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: indigo
+      accent: blue
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: indigo
+      accent: blue
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  font:
+    text: Inter
+    code: Roboto Mono
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.code.annotate
+    - content.tabs.link
+    - content.code.copy
+  icon:
+    repo: fontawesome/brands/github
+
+markdown_extensions:
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.tabbed:
+      alternate_style: true
+  - admonition
+  - pymdownx.details
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - attr_list
+  - md_in_html
+  - toc:
+      permalink: true
+      toc_depth: 3
+
+plugins:
+  - search:
+      lang: en
+  - minify:
+      minify_html: true
+  - git-revision-date-localized:
+      enable_creation_date: true
+      type: date
+  - mermaid2
+  - mkdocstrings:
+      handlers:
+        python:
+          paths: [..]
+          selection:
+            docstring_style: google
+          rendering:
+            show_source: true
+            show_root_heading: true
+            show_root_toc_entry: true
+
+extra_javascript:
+  - javascripts/mathjax.js
+  - https://polyfill.io/v3/polyfill.min.js?features=es6
+  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
+
+extra_css:
+  - css/custom.css
+  - stylesheets/extra.css
+
+nav:
+  - Home: index.md
+  - Getting Started:
+    - Installation: getting-started/installation.md
+    - Quickstart: getting-started/quickstart.md
+    - Configuration: getting-started/configuration.md
+    - First Agent: getting-started/first-agent.md
+  - Core Modules:
+    - CRCAAgent:
+      - Overview: core/crcagent/overview.md
+      - Initialization: core/crcagent/initialization.md
+      - Automatic Extraction: core/crcagent/automatic-extraction.md
+      - Dual-Mode Operation: core/crcagent/dual-mode-operation.md
+      - Causal Graph: core/crcagent/causal-graph.md
+      - Deterministic Simulation: core/crcagent/deterministic-simulation.md
+      - Counterfactuals: core/crcagent/counterfactuals.md
+      - Batch Prediction: core/crcagent/batch-prediction.md
+      - Async Operations: core/crcagent/async-operations.md
+      - Optimization: core/crcagent/optimization.md
+      - Time-Series: core/crcagent/time-series.md
+      - Bayesian Inference: core/crcagent/bayesian-inference.md
+    - Utils:
+      - Overview: core/utils/overview.md
+      - Router: core/utils/router.md
+      - Conversation: core/utils/conversation.md
+      - Graph Reasoner: core/utils/graph-reasoner.md
+      - Utilities: core/utils/utilities.md
+    - Templates:
+      - Overview: core/templates/overview.md
+      - Base Agent: core/templates/base-agent.md
+      - Feature Mixins: core/templates/feature-mixins.md
+      - Templates Guide: core/templates/templates-guide.md
+    - Schemas:
+      - Overview: core/schemas/overview.md
+      - Annotation: core/schemas/annotation.md
+      - Core Schemas: core/schemas/core-schemas.md
+      - Policy: core/schemas/policy.md
+    - Tools:
+      - Overview: core/tools/overview.md
+      - MCP Client: core/tools/mcp-client.md
+  - Branches:
+    - CRCA-Q:
+      - Overview: branches/crca-q/overview.md
+      - Philosophy: branches/crca-q/philosophy.md
+      - Architecture: branches/crca-q/architecture.md
+      - Market Data: branches/crca-q/market-data.md
+      - Alternative Data: branches/crca-q/alternative-data.md
+      - Signal Generation: branches/crca-q/signal-generation.md
+      - Causal Engine: branches/crca-q/causal-engine.md
+      - Signal Validation: branches/crca-q/signal-validation.md
+      - Portfolio Optimization: branches/crca-q/portfolio-optimization.md
+      - Risk Management: branches/crca-q/risk-management.md
+      - Execution: branches/crca-q/execution.md
+      - Backtesting: branches/crca-q/backtesting.md
+      - Setup: branches/crca-q/setup.md
+    - CRCA-SD:
+      - Overview: branches/crca-sd/overview.md
+      - Core: branches/crca-sd/core.md
+      - MPC Solver: branches/crca-sd/mpc-solver.md
+      - Governance: branches/crca-sd/governance.md
+      - Real-Time: branches/crca-sd/realtime.md
+      - TUI: branches/crca-sd/tui.md
+    - CRCA-CG:
+      - Overview: branches/crca-cg/overview.md
+      - CorporateSwarm: branches/crca-cg/corposwarm.md
+      - ESG Scoring: branches/crca-cg/esg-scoring.md
+      - Multi-Agent: branches/crca-cg/multi-agent.md
+    - General Agent:
+      - Overview: branches/general-agent/overview.md
+      - Personality: branches/general-agent/personality.md
+      - Prompt Builder: branches/general-agent/prompt-builder.md
+  - Features:
+    - Image Annotation:
+      - Overview: features/image-annotation/overview.md
+      - Quickstart: features/image-annotation/quickstart.md
+      - Engine: features/image-annotation/engine.md
+      - Features: features/image-annotation/features.md
+      - Integration: features/image-annotation/integration.md
+    - Policy Engine:
+      - Overview: features/policy-engine/overview.md
+      - Doctrine & Ledger: features/policy-engine/doctrine-ledger.md
+      - MPC & Control: features/policy-engine/mpc-control.md
+      - Monitoring & Drift Detection: features/policy-engine/monitoring.md
+    - Hybrid Agent:
+      - Overview: features/hybrid-agent/overview.md
+      - Core Components: features/hybrid-agent/core-components.md
+      - Advanced Components: features/hybrid-agent/advanced-components.md
+    - Causal Reasoning:
+      - Overview: features/causal-reasoning/overview.md
+      - Structural Models: features/causal-reasoning/structural-models.md
+      - Do-Calculus: features/causal-reasoning/do-calculus.md
+      - Counterfactuals: features/causal-reasoning/counterfactuals.md
+      - Advanced Topics: features/causal-reasoning/advanced-topics.md
+  - LRM:
+    - Overview: lrm/overview.md
+    - Full Finetune: lrm/finetune_full.md
+    - Math Appendix: lrm/math_appendix.md
+    - Discovery Proof Notes: lrm/discovery_proof_notes.md
+  - Examples:
+    - Overview: examples/overview.md
+    - Basic Usage: examples/basic-usage.md
+    - General Agent: examples/general-agent/general-agent-examples.md
+    - Hybrid Agent: examples/hybrid-agent/hybrid-agent-examples.md
+    - Image Annotation: examples/image-annotation/image-annotation-examples.md
+    - Trading: examples/trading/trading-examples.md
+    - Integration: examples/integration/integration-examples.md
+  - Architecture:
+    - Overview: architecture/overview.md
+    - Design Principles: architecture/design-principles.md
+    - Data Flow: architecture/data-flow.md
+    - Modular Structure: architecture/modular-structure.md
+    - Hybrid Agent:
+      - Overview: architecture/hybrid-agent/overview.md
+      - Components: architecture/hybrid-agent/components.md
+      - Consistency: architecture/hybrid-agent/consistency.md
+      - Reasoning: architecture/hybrid-agent/reasoning.md
+    - Causal Graphs: architecture/causal-graphs.md
+    - LLM Integration: architecture/llm-integration.md
+    - Policy Engine: architecture/policy-engine-arch.md
+  - API Reference:
+    - CRCAAgent:
+      - Overview: api/crca/overview.md
+      - Agent & Methods: api/crca/agent-methods.md
+      - Operations: api/crca/operations.md
+    - Utils:
+      - Overview: api/utils/overview.md
+      - Router: api/utils/router.md
+      - Conversation: api/utils/conversation.md
+      - Graph Reasoner: api/utils/graph-reasoner.md
+      - Utilities: api/utils/utilities.md
+    - Schemas:
+      - Overview: api/schemas/overview.md
+      - Annotation: api/schemas/annotation.md
+      - Core Schemas: api/schemas/core-schemas.md
+      - Policy: api/schemas/policy.md
+    - Branches:
+      - Overview: api/branches/overview.md
+      - CRCA-Q: api/branches/crca-q.md
+      - CRCA-SD: api/branches/crca-sd.md
+      - CRCA-CG: api/branches/crca-cg.md
+      - General Agent: api/branches/general-agent.md
+    - Image Annotation:
+      - Overview: api/image-annotation/overview.md
+      - Engine: api/image-annotation/engine.md
+  - Schema Contracts:
+    - Overview: ../docs_generated/crca_core/index.md
+    - DraftSpec: ../docs_generated/crca_core/DraftSpec.md
+    - LockedSpec: ../docs_generated/crca_core/LockedSpec.md
+    - IdentificationResult: ../docs_generated/crca_core/IdentificationResult.md
+    - DiscoveryHypothesisResult: ../docs_generated/crca_core/DiscoveryHypothesisResult.md
+    - InterventionDesignResult: ../docs_generated/crca_core/InterventionDesignResult.md
+    - CounterfactualResult: ../docs_generated/crca_core/CounterfactualResult.md
+    - EstimateResult: ../docs_generated/crca_core/EstimateResult.md
+  - Changelog: changelog/index.md
+  - Contributing: contributing/overview.md

ollama/Modelfile

@@ -0,0 +1,8 @@
+FROM ./crca_lrm.gguf
+
+TEMPLATE "<|im_start|>system\n{{ .System }}<|im_end|>\n<|im_start|>user\n{{ .Prompt }}<|im_end|>\n<|im_start|>assistant\n"
+PARAMETER stop "<|im_end|>"
+PARAMETER stop "<|im_start|>"
+PARAMETER num_ctx 8192
+
+SYSTEM "You are CR-CA LRM. Use tool-gated reasoning and refuse numeric causal outputs unless validated by crca_core."

prompts/__init__.py

@@ -5,6 +5,7 @@ Contains system prompts and instructions for LLM agents using CRCAAgent.
 """
 
 from .default_crca import DEFAULT_CRCA_SYSTEM_PROMPT
+from .image_annotation import RESTRICTED_LABELER_SYSTEM_PROMPT
 
-__all__ = ['DEFAULT_CRCA_SYSTEM_PROMPT']
+__all__ = ['DEFAULT_CRCA_SYSTEM_PROMPT', 'RESTRICTED_LABELER_SYSTEM_PROMPT']
 

prompts/default_crca.py

@@ -29,7 +29,15 @@ Your primary role is to help users perform causal reasoning, counterfactual anal
 
 ## Available Tools
 
-You have access to two specialized tools that you can call as functions:
+You have access to several specialized tools that you can call as functions:
+
+### Image Annotation Tools (if available)
+
+**annotate_image**: Annotate images with geometric primitives, semantic labels, and measurements. Automatically detects image type, tunes parameters, and extracts primitives. Use this when you need to analyze images, extract geometric features, or get structured annotations.
+
+**query_image**: Answer specific queries about images using natural language. Use this when you need to find specific objects, measure dimensions, count items, or answer questions about image content.
+
+### Causal Reasoning Tools
 
 ### 1. extract_causal_variables
 **When to use:** When the causal graph is empty or you need to identify variables and relationships from a task description.