bridgekit 0.1.0__tar.gz

bridgekit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Iva Ivanova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bridgekit-0.1.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: bridgekit
+Version: 0.1.0
+Summary: AI tools that make you a better data scientist, not a redundant one.
+License: MIT
+Project-URL: Homepage, https://github.com/bridgekit/bridgekit
+Project-URL: Issues, https://github.com/bridgekit/bridgekit/issues
+Keywords: data science,AI,analysis,evaluation,anthropic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.20.0
+Dynamic: license-file
+
+# Bridgekit
+
+**AI tools that make you a better data scientist, not a redundant one.**
+
+Data scientists are not being replaced — they're being asked to do more with less context, less time, and more pressure to be right. Bridgekit is a growing suite of small, focused tools that bring AI into your existing workflow to sharpen your thinking, catch your blind spots, and level up your craft.
+
+No new interface to learn. No data leaving your hands. Just better work.
+
+---
+
+## Tool #1: Analysis Reviewer
+
+Write your findings the way you normally would. Bridgekit reads them and gives you the feedback a senior data scientist would — before you walk into the meeting.
+
+```python
+from bridgekit import evaluate
+
+text = """
+I analyzed 90 days of user behavior data to understand what drives subscription 
+upgrades. Users who engaged with the reporting feature within their first week 
+were 3x more likely to upgrade within 30 days. I recommend we prioritize 
+onboarding users to reporting as a growth lever.
+"""
+
+evaluate(text)
+```
+
+**Output:**
+
+```
+BRIDGEKIT FEEDBACK
+─────────────────────────────────────────
+
+✅ LOGIC
+Your conclusion follows from the data. The 3x lift is a meaningful signal 
+worth acting on.
+
+⚠️  WHAT'S MISSING
+- Did you control for user intent? Users who explore reporting features may 
+  already be power users likely to upgrade regardless.
+- What's the sample size behind the 3x figure?
+- Is this correlation or did you establish any causal direction?
+
+🎯 WEAKEST POINT
+"I recommend we prioritize onboarding to reporting" is a big leap from an 
+observational finding. A senior DS would push back on this in the meeting.
+
+💡 LEVEL UP
+Look into selection bias and how to address it — this analysis would be 
+significantly stronger with a matched cohort or an experiment to validate 
+the finding.
+
+─────────────────────────────────────────
+```
+
+---
+
+## Installation
+
+```bash
+pip install bridgekit
+```
+
+Requires an Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+```
+
+---
+
+## Getting Started
+
+**From the terminal:**
+
+```bash
+python example.py
+```
+
+**From a Jupyter notebook:**
+
+Set your API key before launching Jupyter:
+
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+jupyter notebook
+```
+
+Then in a cell:
+
+```python
+from bridgekit import evaluate
+
+text = """
+Your analysis writeup goes here.
+"""
+
+print(evaluate(text))
+```
+
+Paste your writeup as a string and call `evaluate()` — that's it.
+
+---
+
+## Why not just use Claude?
+
+You could. But you'd need to know what to ask, how to frame it, and what a good answer looks like. Bridgekit has that baked in — it knows you're a data scientist presenting findings, so it asks the right questions automatically. No prompt engineering required. Just paste your work and run it.
+
+It also lives in your Jupyter notebook, so there's no context switching. You stay in your workflow.
+
+---
+
+## Why a library and not a chatbot?
+
+Because your analysis already lives in a notebook. Bridgekit meets you there. A chatbot asks you to re-explain your work from scratch every time. Bridgekit is one function call at the end of your existing process — consistent, reproducible, and fast.
+
+---
+
+## Is my data safe?
+
+Bridgekit only ever sees text you write yourself — your narrative, your conclusions, your writeup. It never touches your raw data, your DataFrames, or your code. You're sending your own words to an API, the same way you'd paste them into a Google Doc to share with a colleague.
+
+---
+
+## What's next?
+
+Bridgekit is a suite, not a one-off. The analysis reviewer is tool #1. Coming next:
+
+- **Statistical approach suggester** — describe your problem in plain English, get the right test and why
+- **Stakeholder translator** — turn your technical findings into a narrative a non-technical audience will actually follow
+- **Assumption checker** — state your analytical assumptions, get the ones you missed
+
+Each tool is small, focused, and built for the way data scientists actually work.
+
+---
+
+## Contributing
+
+Bridgekit is open source and early. If you're a data scientist and something here would genuinely save you time or make you sharper — open an issue, submit a PR, or just tell me what's missing.
+
+---
+
+## License
+
+MIT

bridgekit-0.1.0/README.md

@@ -0,0 +1,145 @@
+# Bridgekit
+
+**AI tools that make you a better data scientist, not a redundant one.**
+
+Data scientists are not being replaced — they're being asked to do more with less context, less time, and more pressure to be right. Bridgekit is a growing suite of small, focused tools that bring AI into your existing workflow to sharpen your thinking, catch your blind spots, and level up your craft.
+
+No new interface to learn. No data leaving your hands. Just better work.
+
+---
+
+## Tool #1: Analysis Reviewer
+
+Write your findings the way you normally would. Bridgekit reads them and gives you the feedback a senior data scientist would — before you walk into the meeting.
+
+```python
+from bridgekit import evaluate
+
+text = """
+I analyzed 90 days of user behavior data to understand what drives subscription 
+upgrades. Users who engaged with the reporting feature within their first week 
+were 3x more likely to upgrade within 30 days. I recommend we prioritize 
+onboarding users to reporting as a growth lever.
+"""
+
+evaluate(text)
+```
+
+**Output:**
+
+```
+BRIDGEKIT FEEDBACK
+─────────────────────────────────────────
+
+✅ LOGIC
+Your conclusion follows from the data. The 3x lift is a meaningful signal 
+worth acting on.
+
+⚠️  WHAT'S MISSING
+- Did you control for user intent? Users who explore reporting features may 
+  already be power users likely to upgrade regardless.
+- What's the sample size behind the 3x figure?
+- Is this correlation or did you establish any causal direction?
+
+🎯 WEAKEST POINT
+"I recommend we prioritize onboarding to reporting" is a big leap from an 
+observational finding. A senior DS would push back on this in the meeting.
+
+💡 LEVEL UP
+Look into selection bias and how to address it — this analysis would be 
+significantly stronger with a matched cohort or an experiment to validate 
+the finding.
+
+─────────────────────────────────────────
+```
+
+---
+
+## Installation
+
+```bash
+pip install bridgekit
+```
+
+Requires an Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+```
+
+---
+
+## Getting Started
+
+**From the terminal:**
+
+```bash
+python example.py
+```
+
+**From a Jupyter notebook:**
+
+Set your API key before launching Jupyter:
+
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+jupyter notebook
+```
+
+Then in a cell:
+
+```python
+from bridgekit import evaluate
+
+text = """
+Your analysis writeup goes here.
+"""
+
+print(evaluate(text))
+```
+
+Paste your writeup as a string and call `evaluate()` — that's it.
+
+---
+
+## Why not just use Claude?
+
+You could. But you'd need to know what to ask, how to frame it, and what a good answer looks like. Bridgekit has that baked in — it knows you're a data scientist presenting findings, so it asks the right questions automatically. No prompt engineering required. Just paste your work and run it.
+
+It also lives in your Jupyter notebook, so there's no context switching. You stay in your workflow.
+
+---
+
+## Why a library and not a chatbot?
+
+Because your analysis already lives in a notebook. Bridgekit meets you there. A chatbot asks you to re-explain your work from scratch every time. Bridgekit is one function call at the end of your existing process — consistent, reproducible, and fast.
+
+---
+
+## Is my data safe?
+
+Bridgekit only ever sees text you write yourself — your narrative, your conclusions, your writeup. It never touches your raw data, your DataFrames, or your code. You're sending your own words to an API, the same way you'd paste them into a Google Doc to share with a colleague.
+
+---
+
+## What's next?
+
+Bridgekit is a suite, not a one-off. The analysis reviewer is tool #1. Coming next:
+
+- **Statistical approach suggester** — describe your problem in plain English, get the right test and why
+- **Stakeholder translator** — turn your technical findings into a narrative a non-technical audience will actually follow
+- **Assumption checker** — state your analytical assumptions, get the ones you missed
+
+Each tool is small, focused, and built for the way data scientists actually work.
+
+---
+
+## Contributing
+
+Bridgekit is open source and early. If you're a data scientist and something here would genuinely save you time or make you sharper — open an issue, submit a PR, or just tell me what's missing.
+
+---
+
+## License
+
+MIT

bridgekit-0.1.0/bridgekit/__init__.py

@@ -0,0 +1,4 @@
+from .reviewer import evaluate
+
+__version__ = "0.1.0"
+__all__ = ["evaluate"]

bridgekit-0.1.0/bridgekit/reviewer.py

@@ -0,0 +1,79 @@
+import os
+import anthropic
+
+SYSTEM_PROMPT = """You are a senior data scientist reviewing a colleague's analysis writeup. 
+You are direct, constructive, and specific. You do not flatter — you help people improve.
+
+Evaluate the writeup across exactly these five dimensions:
+
+1. CLARITY — Is it free of jargon? Could someone outside data science read this without googling anything?
+2. AUDIENCE CLARITY — Is it written for the right reader? Does the level of detail and framing match who will actually read this?
+3. STATISTICAL RIGOR — Is there enough data to support the claim? Are sample sizes mentioned? Are confidence levels or uncertainty acknowledged?
+4. METHODOLOGY — Is it clear why this analytical approach was chosen? Are alternatives considered or ruled out?
+5. BUSINESS IMPACT — Are outcomes quantified in % or $ terms? Directional statements like "improved performance" are not enough.
+
+For each dimension, give one of three ratings:
+✅ STRONG — this dimension is handled well
+⚠️  NEEDS WORK — specific improvement needed
+❌ MISSING — this dimension is not addressed at all
+
+Follow each rating with 1-3 sentences of specific, actionable feedback. No fluff.
+
+End with a BOTTOM LINE: one sentence on the single most important thing to fix before presenting this.
+
+Format your response exactly like this:
+
+BRIDGEKIT ANALYSIS REVIEW
+─────────────────────────────────────────
+
+1. CLARITY
+[rating] [feedback]
+
+2. AUDIENCE CLARITY
+[rating] [feedback]
+
+3. STATISTICAL RIGOR
+[rating] [feedback]
+
+4. METHODOLOGY
+[rating] [feedback]
+
+5. BUSINESS IMPACT
+[rating] [feedback]
+
+─────────────────────────────────────────
+BOTTOM LINE
+[one sentence]
+"""
+
+def evaluate(text: str) -> str:
+    """
+    Evaluate a data science analysis writeup and return structured feedback.
+
+    Args:
+        text: Your analysis writeup as a plain string.
+
+    Returns:
+        Structured feedback across five dimensions.
+    """
+    api_key = os.environ.get("ANTHROPIC_API_KEY")
+    if not api_key:
+        raise EnvironmentError(
+            "ANTHROPIC_API_KEY not found. Set it with: export ANTHROPIC_API_KEY=your_key_here"
+        )
+
+    client = anthropic.Anthropic(api_key=api_key)
+
+    message = client.messages.create(
+        model="claude-opus-4-5",
+        max_tokens=1024,
+        system=SYSTEM_PROMPT,
+        messages=[
+            {
+                "role": "user",
+                "content": f"Please review this analysis writeup:\n\n{text}"
+            }
+        ]
+    )
+
+    return message.content[0].text

bridgekit-0.1.0/bridgekit.egg-info/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: bridgekit
+Version: 0.1.0
+Summary: AI tools that make you a better data scientist, not a redundant one.
+License: MIT
+Project-URL: Homepage, https://github.com/bridgekit/bridgekit
+Project-URL: Issues, https://github.com/bridgekit/bridgekit/issues
+Keywords: data science,AI,analysis,evaluation,anthropic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.20.0
+Dynamic: license-file
+
+# Bridgekit
+
+**AI tools that make you a better data scientist, not a redundant one.**
+
+Data scientists are not being replaced — they're being asked to do more with less context, less time, and more pressure to be right. Bridgekit is a growing suite of small, focused tools that bring AI into your existing workflow to sharpen your thinking, catch your blind spots, and level up your craft.
+
+No new interface to learn. No data leaving your hands. Just better work.
+
+---
+
+## Tool #1: Analysis Reviewer
+
+Write your findings the way you normally would. Bridgekit reads them and gives you the feedback a senior data scientist would — before you walk into the meeting.
+
+```python
+from bridgekit import evaluate
+
+text = """
+I analyzed 90 days of user behavior data to understand what drives subscription 
+upgrades. Users who engaged with the reporting feature within their first week 
+were 3x more likely to upgrade within 30 days. I recommend we prioritize 
+onboarding users to reporting as a growth lever.
+"""
+
+evaluate(text)
+```
+
+**Output:**
+
+```
+BRIDGEKIT FEEDBACK
+─────────────────────────────────────────
+
+✅ LOGIC
+Your conclusion follows from the data. The 3x lift is a meaningful signal 
+worth acting on.
+
+⚠️  WHAT'S MISSING
+- Did you control for user intent? Users who explore reporting features may 
+  already be power users likely to upgrade regardless.
+- What's the sample size behind the 3x figure?
+- Is this correlation or did you establish any causal direction?
+
+🎯 WEAKEST POINT
+"I recommend we prioritize onboarding to reporting" is a big leap from an 
+observational finding. A senior DS would push back on this in the meeting.
+
+💡 LEVEL UP
+Look into selection bias and how to address it — this analysis would be 
+significantly stronger with a matched cohort or an experiment to validate 
+the finding.
+
+─────────────────────────────────────────
+```
+
+---
+
+## Installation
+
+```bash
+pip install bridgekit
+```
+
+Requires an Anthropic API key:
+
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+```
+
+---
+
+## Getting Started
+
+**From the terminal:**
+
+```bash
+python example.py
+```
+
+**From a Jupyter notebook:**
+
+Set your API key before launching Jupyter:
+
+```bash
+export ANTHROPIC_API_KEY=your_key_here
+jupyter notebook
+```
+
+Then in a cell:
+
+```python
+from bridgekit import evaluate
+
+text = """
+Your analysis writeup goes here.
+"""
+
+print(evaluate(text))
+```
+
+Paste your writeup as a string and call `evaluate()` — that's it.
+
+---
+
+## Why not just use Claude?
+
+You could. But you'd need to know what to ask, how to frame it, and what a good answer looks like. Bridgekit has that baked in — it knows you're a data scientist presenting findings, so it asks the right questions automatically. No prompt engineering required. Just paste your work and run it.
+
+It also lives in your Jupyter notebook, so there's no context switching. You stay in your workflow.
+
+---
+
+## Why a library and not a chatbot?
+
+Because your analysis already lives in a notebook. Bridgekit meets you there. A chatbot asks you to re-explain your work from scratch every time. Bridgekit is one function call at the end of your existing process — consistent, reproducible, and fast.
+
+---
+
+## Is my data safe?
+
+Bridgekit only ever sees text you write yourself — your narrative, your conclusions, your writeup. It never touches your raw data, your DataFrames, or your code. You're sending your own words to an API, the same way you'd paste them into a Google Doc to share with a colleague.
+
+---
+
+## What's next?
+
+Bridgekit is a suite, not a one-off. The analysis reviewer is tool #1. Coming next:
+
+- **Statistical approach suggester** — describe your problem in plain English, get the right test and why
+- **Stakeholder translator** — turn your technical findings into a narrative a non-technical audience will actually follow
+- **Assumption checker** — state your analytical assumptions, get the ones you missed
+
+Each tool is small, focused, and built for the way data scientists actually work.
+
+---
+
+## Contributing
+
+Bridgekit is open source and early. If you're a data scientist and something here would genuinely save you time or make you sharper — open an issue, submit a PR, or just tell me what's missing.
+
+---
+
+## License
+
+MIT

bridgekit-0.1.0/bridgekit.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+bridgekit/__init__.py
+bridgekit/reviewer.py
+bridgekit.egg-info/PKG-INFO
+bridgekit.egg-info/SOURCES.txt
+bridgekit.egg-info/dependency_links.txt
+bridgekit.egg-info/requires.txt
+bridgekit.egg-info/top_level.txt

bridgekit-0.1.0/bridgekit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bridgekit-0.1.0/bridgekit.egg-info/requires.txt

@@ -0,0 +1 @@
+anthropic>=0.20.0

bridgekit-0.1.0/bridgekit.egg-info/top_level.txt

@@ -0,0 +1 @@
+bridgekit

bridgekit-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bridgekit"
+version = "0.1.0"
+description = "AI tools that make you a better data scientist, not a redundant one."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["data science", "AI", "analysis", "evaluation", "anthropic"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+    "anthropic>=0.20.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/bridgekit/bridgekit"
+Issues = "https://github.com/bridgekit/bridgekit/issues"

bridgekit-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+