/intelligems-core
Shared library that powers all Intelligems Analytics skills. Sets up your workspace with the API client, metric helpers, and configuration.
You rarely need to run this directly — other skills (like /test-verdict) automatically check for the workspace and set it up if needed.
What's Included
| File | Purpose |
|---|---|
ig_client.py | API client with automatic retry and rate-limit handling |
ig_metrics.py | Extract values, uplift, confidence, and CI bounds from API responses |
ig_helpers.py | Formatting, runtime calculation, variation lookup |
ig_config.py | Shared thresholds (80% confidence, 10-day minimum, etc.) |
ig_slack.py | Slack Block Kit formatting and webhook delivery |
setup_workspace.sh | Creates ~/intelligems-analytics/ with venv and dependencies |
setup_automation.sh | Creates macOS LaunchAgent for scheduled Slack delivery |
Step 1: Get API Key
Ask the user for their Intelligems API key.
"What's your Intelligems API key? You can get one by contacting support@intelligems.io"
Never hardcode or assume an API key.
Step 2: Set Up Workspace
Run the setup script to create the workspace:
bash setup_workspace.shThis creates:
~/intelligems-analytics/— working directory~/intelligems-analytics/venv/— Python virtual environment~/intelligems-analytics/.env— API key configuration
Then save the user's API key:
echo "INTELLIGEMS_API_KEY=<user's key>" > ~/intelligems-analytics/.envStep 3: Copy Core Libraries
Copy all files from references/ into the workspace:
cp references/ig_client.py ~/intelligems-analytics/
cp references/ig_metrics.py ~/intelligems-analytics/
cp references/ig_helpers.py ~/intelligems-analytics/
cp references/ig_config.py ~/intelligems-analytics/Step 4: Verify
Activate the environment and verify the client works:
source ~/intelligems-analytics/venv/bin/activate
python3 -c "
from ig_client import IntelligemsAPI
from dotenv import load_dotenv
import os
load_dotenv()
api = IntelligemsAPI(os.getenv('INTELLIGEMS_API_KEY'))
tests = api.get_active_experiments()
print(f'Connected. Found {len(tests)} active experiment(s).')
"If successful, the workspace is ready for any Intelligems Analytics skill.