From 6674c1d98170e731fdc301915b68bc7f35fc5a21 Mon Sep 17 00:00:00 2001
From: Aditya Suresh <152752311+adi-suresh01@users.noreply.github.com>
Date: Sat, 6 Jun 2026 12:06:42 -0700
Subject: [PATCH] fix: cap exca to restore a working clean install

neuralset 0.0.2 references exca.steps.base.NoValue, which was removed in
exca 0.5.26 (the symbol moved to exca.steps.identity). neuralset 0.0.2
declares exca>=0.5.20, so a fresh install resolves exca 0.5.26 and fails
at import time:

    AttributeError: module 'exca.steps.base' has no attribute 'NoValue'
    (neuralset/events/study.py, in StudyLoader.run)

tribev2 also imports exca directly (exca.ConfDict, exca.TaskInfra) without
declaring it. This adds exca as an explicit dependency, capped to the range
that exposes the API neuralset 0.0.2 relies on (0.5.20 through 0.5.25).

Verified in a clean Python 3.12 venv: install now resolves exca 0.5.25 and
'from tribev2.demo_utils import TribeModel' imports successfully.

Closes #65
---
 pyproject.toml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/pyproject.toml b/pyproject.toml
index da728956..85b4e442 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -14,6 +14,9 @@ authors = [{name = "Meta Platforms, Inc."}]
 dependencies = [
   "neuralset==0.0.2",
   "neuraltrain==0.0.2",
+  # neuralset 0.0.2 references exca.steps.base.NoValue, which exca removed in
+  # 0.5.26 (moved to exca.steps.identity). Cap exca until neuralset is updated.
+  "exca>=0.5.20,<0.5.26",
   "torch>=2.5.1,<2.7",
   "numpy==2.2.6",
   "torchvision>=0.20,<0.22",