epi-recorder 2.1.3__py3-none-any.whl → 2.2.0__py3-none-any.whl

epi_recorder-2.1.3.dist-info/METADATA

@@ -1,577 +0,0 @@
-Metadata-Version: 2.4
-Name: epi-recorder
-Version: 2.1.3
-Summary: The PDF for AI Evidence - Cryptographic proof of what Autonomous AI Systems actually did.
-Author-email: Mohd Ibrahim Afridi <epitechforworld@outlook.com>
-Maintainer-email: Mohd Ibrahim Afridi <epitechforworld@outlook.com>
-License: Apache-2.0
-Project-URL: Homepage, https://github.com/mohdibrahimaiml/EPI-V2.1.3
-Project-URL: Documentation, https://github.com/mohdibrahimaiml/EPI-V2.1.3#readme
-Project-URL: Repository, https://github.com/mohdibrahimaiml/EPI-V2.1.3
-Project-URL: Issues, https://github.com/mohdibrahimaiml/EPI-V2.1.3/issues
-Keywords: ai,reproducibility,verification,llm,evidence,openai,gemini,cryptography,workflow,audit
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Security :: Cryptography
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: cryptography>=41.0.0
-Requires-Dist: cbor2>=5.6.0
-Requires-Dist: typer[all]>=0.12.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: google-generativeai>=0.4.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: black>=24.0.0; extra == "dev"
-Requires-Dist: ruff>=0.3.0; extra == "dev"
-Dynamic: license-file
-
-<div align="center">
-
-<img src="https://i.postimg.cc/DzKrGyrm/logo.png" alt="EPI Logo" width="120"/>
-
-# EPI Recorder
-
-### The PDF for AI Evidence
-
-**Cryptographic proof of what Autonomous AI Systems actually did.**
-
-[![PyPI](https://img.shields.io/badge/PyPI-v2.1.3-blue?style=flat&logo=pypi&logoColor=white)](https://pypi.org/project/epi-recorder/)
-[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=flat&logo=python&logoColor=white)](https://www.python.org)
-[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg?style=flat)](LICENSE)
-[![Status](https://img.shields.io/badge/Status-v2.1.3-blue?style=flat)](https://github.com/mohdibrahimaiml/EPI-V2.1.3)
-[![Downloads](https://img.shields.io/badge/Downloads-3.8k-blue?style=flat)](https://pypi.org/project/epi-recorder/)
-[![Stars](https://img.shields.io/badge/Stars-16-ea4aaa?style=social&logo=github)](https://github.com/mohdibrahimaiml/EPI-V2.1.3)
-
-[**🚀 Quick Start**](#-quick-start-30-seconds) • [**📖 Docs**](https://epilabs.org/docs) • [**💬 Community**](https://github.com/mohdibrahimaiml/EPI-V2.1.3/discussions) • [**🎥 Demo**](https://colab.research.google.com/github/mohdibrahimaiml/EPI-V2.1.3/blob/main/colab_demo.ipynb)
-
-</div>
-
----
-
-> [!NOTE]
-> **What is EPI?** A `.epi` file is the **"PDF for AI Evidence"**—cryptographically signed, tamper-proof records of what your AI did. One command. Complete proof. Forever.
-
----
-
-## ⚡ Quick Start (30 Seconds)
-
-### Installation
-
-**One command. Works everywhere. 99% success rate.**
-
-**Unix/Mac:**
-```bash
-curl -sSL https://raw.githubusercontent.com/mohdibrahimaiml/EPI-V2.1.3/main/scripts/install.sh | sh
-```
-
-**Windows:**
-```powershell
-iwr https://raw.githubusercontent.com/mohdibrahimaiml/EPI-V2.1.3/main/scripts/install.ps1 -useb | iex
-```
-
-**Manual (pip):**
-```bash
-pip install epi-recorder
-```
-
-> [!TIP]
-> If you see `epi: command not found`, use `python -m epi_cli` instead (always works!)
-
-### Your First Recording
-
-```bash
-# 1. Create a simple script
-echo 'print("Hello, EPI!")' > hello.py
-
-# 2. Record it
-epi run hello.py
-
-# 3. View the cryptographically signed evidence
-#    (Opens in browser automatically)
-```
-
-**That's it!** You just created verifiable AI evidence. 🎉
-
----
-
-## 💡 What is EPI?
-
-**EPI creates cryptographically signed "receipts" for AI workflows.**
-
-Just like PDF standardized documents, **EPI standardizes AI execution evidence**.
-
-### Without EPI ❌
-
-```python
-# Traditional logging
-logger.info("AI decided: APPROVE loan $50K")
-# ⚠️ Can be edited
-# ⚠️ No proof
-# ⚠️ No audit trail
-```
-
-### With EPI ✅
-
-```python
-epi run loan_agent.py
-# Creates: loan_agent_2024_12_16.epi
-
-# ✓ Cryptographically signed
-# ✓ Complete execution snapshot
-# ✓ Tamper-proof evidence
-# ✓ Regulator-ready
-# ✓ Interactive viewer
-```
-
-**Result:** One `.epi` file that proves exactly what happened—**mathematically verifiable**.
-
----
-
-## 🎯 Why EPI?
-
-> [!IMPORTANT]
-> **The Problem:** AI agents make critical decisions (trading, diagnostics, contracts). You need **cryptographic proof**, not just logs that can be edited.
-
-### Traditional Approach ❌
-
-```
-[2024-12-16 14:30:22] INFO: Processing transaction
-[2024-12-16 14:30:23] INFO: Decision: APPROVE
-```
-
-**Problems:**
-- ❌ Logs can be edited after the fact
-- ❌ No cryptographic verification
-- ❌ Missing execution context
-- ❌ Can't reproduce
-- ❌ Regulators won't accept it
-
-### EPI Approach ✅
-
-```bash
-epi run trading_bot.py
-```
-
-**Creates immutable package with:**
-
-| Component | Details | Purpose |
-|-----------|---------|---------|
-| **Code snapshot** | Exact source that executed | Reproducibility |
-| **API calls** | Every request/response | Auditability |
-| **File I/O** | All reads/writes captured | Data lineage |
-| **Environment** | Python version, OS, dependencies | Context |
-| **Signatures** | Ed25519 cryptographic proof | Integrity |
-| **Timeline** | Interactive browser viewer | Understanding |
-
-> [!NOTE]
-> **If it's in the .epi file, it happened. If it's not, it didn't.** Period.
-
----
-
-## 🔍 How EPI Compares
-
-### vs Traditional Tools
-
-| Feature | Logs | Screenshots | Video | **EPI** |
-|---------|------|-------------|-------|---------|
-| **Tamper-proof** | ❌ | ❌ | ❌ | ✅ |
-| **Cryptographic proof** | ❌ | ❌ | ❌ | ✅ |
-| **Captures code** | ⚠️ Partial | ❌ | ❌ | ✅ |
-| **Interactive viewer** | Custom | Manual | Manual | **Built-in** |
-| **Reproducible** | ❌ | ❌ | ❌ | ✅ |
-| **Regulatory compliant** | ⚠️ | ❌ | ❌ | ✅ |
-| **File size** | Large | Medium | Very large | **Small** |
-
-### vs PDF
-
-| Aspect | PDF | EPI |
-|--------|-----|-----|
-| **Purpose** | Document consistency | **Execution integrity** |
-| **Trust** | "Looks right" | **"Mathematically proven"** |
-| **Security** | ⚠️ Can run JavaScript | ✅ **Static HTML (safe)** |
-| **Use case** | Reports, contracts | **AI workflows, executions** |
-| **Standard** | ISO 32000 | **Emerging** |
-
----
-
-## 🎨 Real-World Examples
-
-### Example 1: Financial Trading Agent
-
-```python
-# trading_bot.py
-import openai
-
-def analyze_stock(symbol):
-    # AI analyzes market
-    response = openai.ChatCompletion.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": f"Analyze {symbol}"}]
-    )
-    
-    decision = response.choices[0].message.content
-    execute_trade(symbol, decision)
-    return decision
-```
-
-**Record it:**
-```bash
-epi run trading_bot.py
-```
-
-**You get:**
-- ✅ Proof of AI decision logic
-- ✅ Complete API call history (keys redacted)
-- ✅ Execution timestamp
-- ✅ Regulatory-compliant audit trail
-- ✅ Shareable evidence package
-
----
-
-### Example 2: Healthcare Diagnostic Agent
-
-```python
-# diagnostic_agent.py
-def diagnose_patient(patient_data):
-    # AI analysis
-    diagnosis = ai_model.predict(patient_data)
-    
-    # Generate FDA-compliant report
-    report = create_medical_report(diagnosis)
-    
-    return diagnosis, report
-```
-
-**Record for FDA submission:**
-```bash
-epi run diagnostic_agent.py
-```
-
-**Evidence includes:**
-- ✅ Model version used
-- ✅ Input data processing (HIPAA-compliant)
-- ✅ Decision logic captured
-- ✅ Cryptographic proof for regulators
-
----
-
-### Example 3: Python API
-
-**Zero-config decorator:**
-
-```python
-from epi_recorder import record
-
-@record(out="workflow.epi")
-def my_ai_workflow():
-    result = llm.generate_response(prompt)
-    save_to_database(result)
-    return result
-
-# Automatically creates workflow.epi
-my_ai_workflow()
-```
-
-**Context manager:**
-
-```python
-from epi_recorder import record
-
-with record("analysis.epi"):
-    # Everything here is captured
-    data = fetch_data()
-    insights = analyze_with_ai(data)
-    send_report(insights)
-```
-
----
-
-## 🎮 Commands Reference
-
-### Core Commands
-
-```bash
-# Interactive setup (first time)
-epi init
-
-# Record any script
-epi run script.py
-
-# View evidence package
-epi view recording.epi
-
-# Verify cryptographic integrity
-epi verify recording.epi
-
-# List all recordings
-epi ls
-
-# Self-healing diagnostics
-epi doctor
-```
-
-### Advanced
-
-```bash
-# Custom output name
-epi record --out experiment.epi -- python train.py
-
-# Record any command (not just Python)
-epi record --out build.epi -- npm run build
-
-# Manage cryptographic keys
-epi keys generate --name production
-epi keys list
-epi keys export --name production
-```
-
-> [!TIP]
-> **All commands also work as:** `python -m epi_cli <command>` (100% reliable, bypasses PATH)
-
----
-
-## 🔒 Security & Privacy
-
-### Automatic Redaction
-
-**Sensitive data is automatically masked:**
-
-```python
-# Your code
-openai.api_key = "sk-abc123xyz"
-db_password = "secret123"
-
-# In .epi file (automatic)
-openai.api_key = "sk-***REDACTED***"
-db_password = "***REDACTED***"
-```
-
-**Protected:**
-- ✅ API keys (OpenAI, Anthropic, AWS, etc.)
-- ✅ Passwords and tokens
-- ✅ Environment variables with secrets
-- ✅ Database credentials
-
-### Cryptographic Integrity
-
-**Every .epi file:**
-- 🔐 Signed with Ed25519 (same as Signal, SSH)
-- ✅ Tamper-proof (any modification breaks signature)
-- 🔍 Publicly verifiable (anyone can check)
-- 🔑 Private key stays on your machine
-
-### Offline Viewing
-
-**The viewer is 100% safe:**
-- ✅ Static HTML (no server needed)
-- ✅ No external requests
-- ✅ No analytics or tracking
-- ✅ Works in air-gapped environments
-- ✅ Safe to share with auditors
-
----
-
-## 🏢 Use Cases
-
-<table>
-<tr>
-<td width="50%">
-
-### 💼 Financial Services
-- Regulatory compliance (MiFID II, Dodd-Frank)
-- Trading algorithm audit trails
-- AI-driven loan decisions
-- Risk assessment transparency
-
-</td>
-<td width="50%">
-
-### 🏥 Healthcare
-- FDA AI/ML submissions
-- Clinical trial reproducibility
-- HIPAA-compliant audit logs
-- Diagnostic algorithm evidence
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### ⚖️ Legal
-- E-discovery for AI systems
-- Contract analysis evidence
-- Litigation documentation
-- Chain of custody
-
-</td>
-<td width="50%">
-
-### 🔬 Research
-- ML experiment reproducibility
-- Peer review verification
-- Grant compliance
-- Published results validation
-
-</td>
-</tr>
-</table>
-
----
-
-## ❓ FAQ
-
-<details>
-<summary><b>How is EPI different from logging?</b></summary>
-
-Logs can be edited after the fact. EPI files are **cryptographically signed**—any tampering breaks the signature. Think of it as the difference between a handwritten note and a notarized document.
-
-</details>
-
-<details>
-<summary><b>Does this slow down my code?</b></summary>
-
-Minimal overhead (~5%). EPI records in the background, so your code runs at near-native speed.
-
-</details>
-
-<details>
-<summary><b>Can I use this in production?</b></summary>
-
-**Yes!** EPI is designed for production AI systems. It's used by companies in finance, healthcare, and research for regulatory compliance.
-
-</details>
-
-<details>
-<summary><b>Is my data safe?</b></summary>
-
-EPI automatically redacts API keys and secrets. The viewer is 100% offline (static HTML). You control what gets shared.
-
-</details>
-
-<details>
-<summary><b>What about large datasets?</b></summary>
-
-EPI captures **code + metadata**, not raw data. Typical `.epi` file: <10MB. Large datasets are referenced, not embedded.
-
-</details>
-
-<details>
-<summary><b>What if `epi` command doesn't work?</b></summary>
-
-Use `python -m epi_cli` instead (always works). Or run `python -m epi_cli doctor` to auto-fix PATH issues.
-
-</details>
-
----
-
-## 🆕 What's New in v2.1.3
-
-> [!IMPORTANT]
-> **Gemini Native:** EPI now natively supports Google Gemini. Just run your script, and Gemini calls are captured automatically. Plus, talk to your evidence with `epi chat`.
-
-### 🤖 Gemini Integration
-- **Automatic Patcher:** Intercepts `google.generativeai` calls without code changes. Logs prompts, responses, and token usage.
-- **Evidence Chat:** New command `epi chat` allows you to query your `.epi` files using Gemini AI. "What happened in this run?"
-- **Error Capture:** Automatically records API errors like Quota Exceeded (429) or Blocked Content.
-
-### 🛡️ Security & Integrity (v2.1.2)
-- **Client-Side Verification:** The HTML viewer now includes a bundled crypto library to verify signatures offline.
-- **Trust Badges:** UI now explicitly shows "Verified" (Green), "Unsigned" (Yellow), or "Tampered" (Red).
-
-### ✨ Enhanced CLI Reliability
-- **Windows Compatibility:** Fixed Unicode issues in CLI for legacy terminals.
-- **Python Module Fallback:** `python -m epi_cli` works reliably everywhere.
-
-**2. Automatic PATH Configuration**
-- Post-install script auto-fixes PATH on Windows
-- `epi doctor` command detects and repairs issues
-- Success rate improved from 85% → 99%
-
-**3. Universal Installation Scripts**
-- One-command installers for all platforms
-- Auto-configure shell PATH
-- Works on Unix/Mac/Windows
-
-**4. Windows Compatibility**
-- Fixed Unicode errors in terminal output
-- Better error messages
-- More reliable auto-fix
-
-### 🐛 Bug Fixes
-- Fixed `pyproject.toml` syntax warnings
-- Improved terminal output compatibility
-- Better error handling
-
----
-
-## 📚 Documentation
-
-- [**📘 CLI Reference**](docs/CLI.md) - All commands explained
-- [**📖 Quick Start Guide**](QUICKSTART.md) - Get started in 30 seconds
-- [**🏗️ Architecture**](docs/EPI-SPEC.md) - Technical specification
-- [**📝 Product Description**](EPI_Product_Description.md) - Detailed overview
-- [**📋 Examples**](examples/) - Real-world code examples
-
----
-
-## 🤝 Community & Support
-
-- [**💬 Discussions**](https://github.com/mohdibrahimaiml/EPI-V2.1.0/discussions) - Ask questions, share use cases
-- [**🐛 Issues**](https://github.com/mohdibrahimaiml/EPI-V2.1.0/issues) - Bug reports, feature requests
-- [**📧 Email**](mailto:epitechforworld@outlook.com) - Direct support
-- [**🌐 Website**](https://epilabs.org) - Latest news
-
----
-
-## 🙌 Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-**Areas we'd love help:**
-- 🌍 Internationalization
-- 🔌 Language integrations (JavaScript, Go, Rust)
-- ☁️ Cloud storage adapters
-- 📊 Viewer enhancements
-- 📝 Documentation improvements
-
-[**Good First Issues →**](https://github.com/mohdibrahimaiml/EPI-V2.0.0/labels/good%20first%20issue)
-
----
-
-## 📄 License
-
-**Apache 2.0** - See [LICENSE](LICENSE)
-
----
-
-## 🙏 Built With
-
-- [Typer](https://typer.tiangolo.com/) - Beautiful CLIs
-- [Rich](https://rich.readthedocs.io/) - Terminal formatting
-- [Pydantic](https://pydantic-docs.helpmanual.io/) - Data validation
-- [Cryptography](https://cryptography.io/) - Ed25519 signatures
-
----
-
-<div align="center">
-
-### **Trust Your AI. Verify Everything.** 🔐
-
-**Made with ❤️ by [Mohd Ibrahim Afridi](https://github.com/mohdibrahimaiml)**
-
-[**⭐ Star this repo**](https://github.com/mohdibrahimaiml/EPI-V2.0.0) • [**🐦 Follow updates**](https://twitter.com/epilabs) • [**🌐 Visit epilabs.org**](https://epilabs.org)
-
-</div>

epi_recorder-2.1.3.dist-info/RECORD

@@ -1,34 +0,0 @@
-epi_postinstall.py,sha256=9MVuFeA8S25jAp9VMZrAE0M1k2QHC1PeJxful7jcMd8,7066
-epi_cli/__init__.py,sha256=SSpuDlDqVBbPvR21CCRcNOB61EyB8jAUzNd8XISADa8,98
-epi_cli/__main__.py,sha256=wQWpc9XXhXnPyy2hw-WQFGaPM1qNhpKiel2jQm7MhKQ,296
-epi_cli/chat.py,sha256=Y3FinP-Cg1DawBpM7mqWj1BnYh6Hkl3OTKdXi-0QvuE,6693
-epi_cli/keys.py,sha256=bHR6knfGR4g7uGuR2cu5VTcGXVyvtZzVtnRBbgPSaTE,9111
-epi_cli/ls.py,sha256=Ip6OyubkXb_Ba9S7p-U1seWMcWpFeiV-fHhl9ocUy9k,5015
-epi_cli/main.py,sha256=x_sIFkgGKvHN3XQIuCYHlReqL6xVFsOzZJGdPf8eXf8,12165
-epi_cli/record.py,sha256=QtDrjr-7WbfcYXwPRrDDujrubUNrHhp062EcW8DZPNk,7321
-epi_cli/run.py,sha256=dM_AYC3LzDBc_DzVKlb8obZBE52sAe3wYAnce0PLGT4,14101
-epi_cli/verify.py,sha256=Rq34rw-zM_vZmYDsfg8cLlvW76_wJ99Pu-arjGRE9bw,8238
-epi_cli/view.py,sha256=YZYohgT66Z2UYfN37d5VTPxipNiwSMacD4zHYaNypiU,4021
-epi_core/__init__.py,sha256=AM-2ThtcXElMi1HpKmabjRUk365TdSLHva22eqLBfcM,303
-epi_core/container.py,sha256=ZRRAWBoGGLkoqXQVEwfHHXtPE6D0Nqr1fBZpBFyXnKk,12687
-epi_core/redactor.py,sha256=mYVZrIsKJdIJBY2XHE0U_CYqgY4Z2vGRvLW-19_c0WE,9886
-epi_core/schemas.py,sha256=flrPiTN92fbJS0U0wDfzxJvv4MGpUXEoWeu6kxoelRQ,4728
-epi_core/serialize.py,sha256=2zl0SiDqUzk05HYca57Xmfj3x59LBbqEkJYE5TcCCz8,5685
-epi_core/trust.py,sha256=3uy6MGl0-5nDa2ZB_Wj2j25EDmChRWi8ZboketdSXkE,7964
-epi_recorder/__init__.py,sha256=sRrsvbq8yGOKMp0ViutZ9HjurvQgi0rDoWc4DKSXSkY,396
-epi_recorder/api.py,sha256=EZtMF2MVIk8KR1GPJBSxDlEh57nsIc-B2Ok0_j3hZ4U,21561
-epi_recorder/bootstrap.py,sha256=yE1y0rjQ-1D-ZhWFipX_6qXFTA2BPlEm8Ft4Z0iex88,1845
-epi_recorder/environment.py,sha256=NCz_Pckc6GU1kQsYF3oXDsN46k5LVuYWbMEhTj1FRXo,6598
-epi_recorder/patcher.py,sha256=d7yAdoC7rotugkq-lMU0kV6x9rTRVtq5xtC1mXbHsOs,18924
-epi_recorder/test_import.py,sha256=Dhjkj8qYZR4d4w-bshClV6S-naCcS5srW7wsp7jW-cM,459
-epi_recorder/test_script.py,sha256=4uUheXOfqC28NYICyaAxm3gnhfrkdDZtaXnwfjG-qhQ,92
-epi_recorder-2.1.3.dist-info/licenses/LICENSE,sha256=aUgjAzBUkmKIZy3AZ_XAZWoh3kzkRlkOc3JHLVfyF-A,11540
-epi_viewer_static/app.js,sha256=qxOiqj4UBGCzxddctt8XbTeND8m2mwotDnvC7emayfs,14723
-epi_viewer_static/crypto.js,sha256=hjoIrGljQ0Yrg-KplT1zHccK1b82_Y_SfDZ8Gw_UjBc,19078
-epi_viewer_static/index.html,sha256=JxdsgzjJ5nGeDD1ROXI00w8rwsD7wXXOwitizxe8AWs,3298
-epi_viewer_static/viewer_lite.css,sha256=oCEiEYbvdlaMwz-MPlrk3LoTVOad-bDLlP-X49Yw0o0,4691
-epi_recorder-2.1.3.dist-info/METADATA,sha256=BjvScqRYo2TUl_PYAeBz1MpEObF5u-hc7nmBV2t5Eqo,16246
-epi_recorder-2.1.3.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-epi_recorder-2.1.3.dist-info/entry_points.txt,sha256=MfMwqVRx_yMGbuPpiyjz2f8fQp8TUbHmRC1H_bupoyM,41
-epi_recorder-2.1.3.dist-info/top_level.txt,sha256=kvGAjj3uNol1hxRi29Ec-B4HuYK6t-MD7wflkENQA6g,64
-epi_recorder-2.1.3.dist-info/RECORD,,