evolution-sdk 0.8.0__tar.gz

evolution_sdk-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Urvish A. Prajapati (prajapatiurvish712@gmail.com)
+
+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.

evolution_sdk-0.8.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: evolution-sdk
+Version: 0.8.0
+Summary: Python SDK for Evolution — AI-Native Version Control Platform
+Author-email: "Urvish.A.Prajapati" <prajapatiurvish712@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Urvish0/Evolution
+Project-URL: Repository, https://github.com/Urvish0/Evolution
+Project-URL: Specification, https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md
+Keywords: ai,version-control,llm,manifest,evaluation,langchain,llamaindex
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# Evolution Python SDK (`evolution-sdk`)
+
+> **"Version Intelligence, Not Code."**
+
+[![PyPI Version](https://img.shields.io/badge/pypi-v0.8.0-blue.svg)](https://pypi.org/project/evolution-sdk/)
+[![Python Versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/evolution-sdk/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Urvish0/Evolution/blob/main/LICENSE)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20runtime-brightgreen.svg)](#features)
+
+The official Python SDK for **[Evolution](https://github.com/Urvish0/Evolution)** — an open-source, AI-native version control platform.
+
+While traditional version control systems (like Git) track line-by-line changes to text files, **Evolution tracks and versions Intelligence**: the complete operational state of an AI system (system prompts, sampling parameters, memory strategies, vector store retrieval configurations, tool schemas, and guardrails).
+
+---
+
+## ⚡ Key Features
+
+- 🪶 **Zero Runtime Dependencies**: Pure Python implementation with zero third-party dependencies. Ultra-fast, lightweight, and won't conflict with your environment.
+- 🎯 **Automatic Intelligence Capture**: Use the `@evolution.track` decorator to automatically extract docstring prompts, model hyperparameters, token consumption, and latency.
+- ⏱️ **Precision Execution Telemetry**: Record execution traces, inputs, outputs, and hardware latency using `@track` or the `evolution.record` context manager.
+- 🔌 **Universal Framework Adapters**: Seamlessly introspect and export standard Intelligence Manifests from **LangChain**, **LlamaIndex**, **CrewAI**, and direct OpenAI / Anthropic client calls.
+- 🔒 **Git-Compatible CAS Blobs**: Content-Addressable Storage with auto-computed SHA-256 Merkle hashes.
+- 📋 **Intelligence Manifest Spec v1.0 Compliant**: Native support for creating, validating, and saving standard `evolution.manifest.json` schemas.
+
+---
+
+## 📦 Installation
+
+Install `evolution-sdk` via `pip` or `uv`:
+
+```bash
+pip install evolution-sdk
+```
+
+Or using `uv`:
+
+```bash
+uv add evolution-sdk
+```
+
+---
+
+## 🚀 Quickstart in 30 Seconds
+
+### 1. Initialize or Open an Evolution Repository
+
+```python
+import evolution as evo
+
+# Initialize a new Evolution repository in the current directory
+repo = evo.Repository.init("./my_ai_agent")
+
+# Or open an existing repository
+# repo = evo.Repository.open("./my_ai_agent")
+```
+
+---
+
+### 2. Automatic Intelligence Tracking with `@evo.track`
+
+Decorate your AI agent functions. Evolution automatically extracts the docstring as the system prompt, registers model configs, measures latency, and logs execution tokens without modifying your business logic:
+
+```python
+from openai import OpenAI
+import evolution as evo
+
+client = OpenAI()
+repo = evo.Repository.init("./my_agent")
+
+@evo.track(
+    repo=repo,
+    name="customer-support-agent",
+    model="gpt-4o",
+    temperature=0.2,
+)
+def handle_customer_inquiry(user_message: str):
+    """Senior Customer Support Specialist. Always maintain professional tone and provide step-by-step guidance."""
+    response = client.chat.completions.create(
+        model="gpt-4o",
+        temperature=0.2,
+        messages=[
+            {"role": "system", "content": "You are a Senior Customer Support Specialist."},
+            {"role": "user", "content": user_message}
+        ]
+    )
+    return response
+
+# Run your agent
+result = handle_customer_inquiry("How do I reset my API key?")
+
+# Commit the captured intelligence snapshot
+repo.commit("feat: initial customer support intelligence snapshot")
+```
+
+---
+
+### 3. Precision Latency & Execution Recording with `record()`
+
+For fine-grained telemetry or manual pipelines, use the `record` context manager:
+
+```python
+import evolution as evo
+
+repo = evo.Repository.open(".")
+
+with evo.record(repo, metadata={"phase": "testing"}) as ctx:
+    # Set inputs
+    ctx.set_inputs("User asked: Explain Merkle trees.")
+    
+    # Execute your LLM call
+    response_text = "A Merkle tree is a cryptographic tree structure..."
+    
+    # Record outputs and token metrics
+    ctx.set_outputs(response_text)
+    ctx.set_tokens(prompt_tokens=42, completion_tokens=128)
+
+print(f"Recorded execution with duration: {ctx.execution.duration_ms} ms")
+```
+
+---
+
+## 🔌 Framework Adapters
+
+Evolution provides plug-and-play adapters to export standard Intelligence Manifests directly from your existing AI framework abstractions:
+
+### LangChain Adapter
+```python
+from langchain_openai import ChatOpenAI
+from langchain_core.prompts import ChatPromptTemplate
+from evolution.adapters import LangChainAdapter
+
+prompt = ChatPromptTemplate.from_template("Summarize the following legal document: {doc}")
+llm = ChatOpenAI(model="gpt-4o", temperature=0.1)
+chain = prompt | llm
+
+manifest = LangChainAdapter.from_langchain(chain, name="legal-summarizer")
+print(manifest.to_dict())
+```
+
+### LlamaIndex Adapter
+```python
+from llama_index.core import VectorStoreIndex
+from evolution.adapters import LlamaIndexAdapter
+
+manifest = LlamaIndexAdapter.from_llamaindex(
+    index=my_vector_index,
+    name="financial-rag-agent",
+    similarity_top_k=5,
+)
+```
+
+### CrewAI Adapter
+```python
+from crewai import Agent, Crew, Task
+from evolution.adapters import CrewAIAdapter
+
+manifest = CrewAIAdapter.from_crewai(my_crew, name="research-crew")
+```
+
+---
+
+## 📋 The Intelligence Manifest Format (`evolution.manifest.json`)
+
+Evolution stores your complete AI system state in a portable, framework-agnostic manifest following the **[Intelligence Manifest Specification v1.0](https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md)**:
+
+```json
+{
+  "version": "1.0.0",
+  "name": "legal-dispute-resolution-system",
+  "description": "AI system powered by Evolution version control",
+  "artifacts": {
+    "prompts": [
+      {
+        "type": "prompt",
+        "name": "strict-legal-analyst-prompt",
+        "description": "Extracted docstring prompt",
+        "role": "system",
+        "format": "text"
+      }
+    ],
+    "model_config": {
+      "type": "model_config",
+      "name": "analyst-model",
+      "model": "qwen/qwen3.8-27b",
+      "provider": "local",
+      "temperature": 0.1
+    }
+  }
+}
+```
+
+---
+
+## 🧪 Running Tests
+
+To run the SDK test suite:
+
+```bash
+pytest sdk/python/tests/ -v
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🌐 Links
+
+- **GitHub Repository:** [https://github.com/Urvish0/Evolution](https://github.com/Urvish0/Evolution)
+- **Specification:** [Intelligence Manifest Spec v1.0](https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md)
+- **Documentation:** [Technical Manual](https://github.com/Urvish0/Evolution/blob/main/DOCUMENTATION.md)

evolution_sdk-0.8.0/README.md

@@ -0,0 +1,214 @@
+# Evolution Python SDK (`evolution-sdk`)
+
+> **"Version Intelligence, Not Code."**
+
+[![PyPI Version](https://img.shields.io/badge/pypi-v0.8.0-blue.svg)](https://pypi.org/project/evolution-sdk/)
+[![Python Versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/evolution-sdk/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/Urvish0/Evolution/blob/main/LICENSE)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20runtime-brightgreen.svg)](#features)
+
+The official Python SDK for **[Evolution](https://github.com/Urvish0/Evolution)** — an open-source, AI-native version control platform.
+
+While traditional version control systems (like Git) track line-by-line changes to text files, **Evolution tracks and versions Intelligence**: the complete operational state of an AI system (system prompts, sampling parameters, memory strategies, vector store retrieval configurations, tool schemas, and guardrails).
+
+---
+
+## ⚡ Key Features
+
+- 🪶 **Zero Runtime Dependencies**: Pure Python implementation with zero third-party dependencies. Ultra-fast, lightweight, and won't conflict with your environment.
+- 🎯 **Automatic Intelligence Capture**: Use the `@evolution.track` decorator to automatically extract docstring prompts, model hyperparameters, token consumption, and latency.
+- ⏱️ **Precision Execution Telemetry**: Record execution traces, inputs, outputs, and hardware latency using `@track` or the `evolution.record` context manager.
+- 🔌 **Universal Framework Adapters**: Seamlessly introspect and export standard Intelligence Manifests from **LangChain**, **LlamaIndex**, **CrewAI**, and direct OpenAI / Anthropic client calls.
+- 🔒 **Git-Compatible CAS Blobs**: Content-Addressable Storage with auto-computed SHA-256 Merkle hashes.
+- 📋 **Intelligence Manifest Spec v1.0 Compliant**: Native support for creating, validating, and saving standard `evolution.manifest.json` schemas.
+
+---
+
+## 📦 Installation
+
+Install `evolution-sdk` via `pip` or `uv`:
+
+```bash
+pip install evolution-sdk
+```
+
+Or using `uv`:
+
+```bash
+uv add evolution-sdk
+```
+
+---
+
+## 🚀 Quickstart in 30 Seconds
+
+### 1. Initialize or Open an Evolution Repository
+
+```python
+import evolution as evo
+
+# Initialize a new Evolution repository in the current directory
+repo = evo.Repository.init("./my_ai_agent")
+
+# Or open an existing repository
+# repo = evo.Repository.open("./my_ai_agent")
+```
+
+---
+
+### 2. Automatic Intelligence Tracking with `@evo.track`
+
+Decorate your AI agent functions. Evolution automatically extracts the docstring as the system prompt, registers model configs, measures latency, and logs execution tokens without modifying your business logic:
+
+```python
+from openai import OpenAI
+import evolution as evo
+
+client = OpenAI()
+repo = evo.Repository.init("./my_agent")
+
+@evo.track(
+    repo=repo,
+    name="customer-support-agent",
+    model="gpt-4o",
+    temperature=0.2,
+)
+def handle_customer_inquiry(user_message: str):
+    """Senior Customer Support Specialist. Always maintain professional tone and provide step-by-step guidance."""
+    response = client.chat.completions.create(
+        model="gpt-4o",
+        temperature=0.2,
+        messages=[
+            {"role": "system", "content": "You are a Senior Customer Support Specialist."},
+            {"role": "user", "content": user_message}
+        ]
+    )
+    return response
+
+# Run your agent
+result = handle_customer_inquiry("How do I reset my API key?")
+
+# Commit the captured intelligence snapshot
+repo.commit("feat: initial customer support intelligence snapshot")
+```
+
+---
+
+### 3. Precision Latency & Execution Recording with `record()`
+
+For fine-grained telemetry or manual pipelines, use the `record` context manager:
+
+```python
+import evolution as evo
+
+repo = evo.Repository.open(".")
+
+with evo.record(repo, metadata={"phase": "testing"}) as ctx:
+    # Set inputs
+    ctx.set_inputs("User asked: Explain Merkle trees.")
+    
+    # Execute your LLM call
+    response_text = "A Merkle tree is a cryptographic tree structure..."
+    
+    # Record outputs and token metrics
+    ctx.set_outputs(response_text)
+    ctx.set_tokens(prompt_tokens=42, completion_tokens=128)
+
+print(f"Recorded execution with duration: {ctx.execution.duration_ms} ms")
+```
+
+---
+
+## 🔌 Framework Adapters
+
+Evolution provides plug-and-play adapters to export standard Intelligence Manifests directly from your existing AI framework abstractions:
+
+### LangChain Adapter
+```python
+from langchain_openai import ChatOpenAI
+from langchain_core.prompts import ChatPromptTemplate
+from evolution.adapters import LangChainAdapter
+
+prompt = ChatPromptTemplate.from_template("Summarize the following legal document: {doc}")
+llm = ChatOpenAI(model="gpt-4o", temperature=0.1)
+chain = prompt | llm
+
+manifest = LangChainAdapter.from_langchain(chain, name="legal-summarizer")
+print(manifest.to_dict())
+```
+
+### LlamaIndex Adapter
+```python
+from llama_index.core import VectorStoreIndex
+from evolution.adapters import LlamaIndexAdapter
+
+manifest = LlamaIndexAdapter.from_llamaindex(
+    index=my_vector_index,
+    name="financial-rag-agent",
+    similarity_top_k=5,
+)
+```
+
+### CrewAI Adapter
+```python
+from crewai import Agent, Crew, Task
+from evolution.adapters import CrewAIAdapter
+
+manifest = CrewAIAdapter.from_crewai(my_crew, name="research-crew")
+```
+
+---
+
+## 📋 The Intelligence Manifest Format (`evolution.manifest.json`)
+
+Evolution stores your complete AI system state in a portable, framework-agnostic manifest following the **[Intelligence Manifest Specification v1.0](https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md)**:
+
+```json
+{
+  "version": "1.0.0",
+  "name": "legal-dispute-resolution-system",
+  "description": "AI system powered by Evolution version control",
+  "artifacts": {
+    "prompts": [
+      {
+        "type": "prompt",
+        "name": "strict-legal-analyst-prompt",
+        "description": "Extracted docstring prompt",
+        "role": "system",
+        "format": "text"
+      }
+    ],
+    "model_config": {
+      "type": "model_config",
+      "name": "analyst-model",
+      "model": "qwen/qwen3.8-27b",
+      "provider": "local",
+      "temperature": 0.1
+    }
+  }
+}
+```
+
+---
+
+## 🧪 Running Tests
+
+To run the SDK test suite:
+
+```bash
+pytest sdk/python/tests/ -v
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🌐 Links
+
+- **GitHub Repository:** [https://github.com/Urvish0/Evolution](https://github.com/Urvish0/Evolution)
+- **Specification:** [Intelligence Manifest Spec v1.0](https://github.com/Urvish0/Evolution/blob/main/spec/intelligence-manifest-v1.0.md)
+- **Documentation:** [Technical Manual](https://github.com/Urvish0/Evolution/blob/main/DOCUMENTATION.md)

evolution_sdk-0.8.0/evolution/__init__.py

@@ -0,0 +1,102 @@
+"""
+Evolution Python SDK — AI-Native Version Control Platform.
+"Version Intelligence, Not Code."
+"""
+
+from pathlib import Path
+
+from evolution.adapters import (
+    from_anthropic,
+    from_crewai,
+    from_langchain,
+    from_llamaindex,
+    from_openai,
+)
+from evolution.capture import RecordContextManager, record, track
+from evolution.evaluators import (
+    DimensionScore,
+    EvaluationReport,
+    SemanticEvaluator,
+)
+from evolution.exceptions import (
+    ArtifactNotFoundError,
+    CommandExecutionError,
+    EvolutionError,
+    ManifestNotFoundError,
+    ManifestValidationError,
+    RepositoryAlreadyExistsError,
+    RepositoryNotFoundError,
+)
+from evolution.models import (
+    BaseArtifact,
+    EvaluationResult,
+    EvaluationScore,
+    Execution,
+    Manifest,
+    ManifestArtifacts,
+    MemoryArtifact,
+    ModelConfigArtifact,
+    PolicyArtifact,
+    PromptArtifact,
+    RetrievalArtifact,
+    TokenUsage,
+    ToolArtifact,
+    artifact_from_dict,
+    compute_blob_hash,
+)
+from evolution.repository import CommitInfo, RepoStatus, Repository
+
+__version__ = "0.8.0"
+
+
+def init(path: Path | str = ".", name: str = "ai-intelligence") -> Repository:
+    """Convenience function to initialize a new Evolution repository."""
+    return Repository.init(path=path, name=name)
+
+
+def open(path: Path | str = ".") -> Repository:
+    """Convenience function to open an existing Evolution repository."""
+    return Repository.open(path=path)
+
+
+__all__ = [
+    "ArtifactNotFoundError",
+    "BaseArtifact",
+    "CommandExecutionError",
+    "CommitInfo",
+    "DimensionScore",
+    "EvaluationReport",
+    "EvaluationResult",
+    "EvaluationScore",
+    "EvolutionError",
+    "Execution",
+    "Manifest",
+    "ManifestArtifacts",
+    "ManifestNotFoundError",
+    "ManifestValidationError",
+    "MemoryArtifact",
+    "ModelConfigArtifact",
+    "PolicyArtifact",
+    "PromptArtifact",
+    "RecordContextManager",
+    "RepoStatus",
+    "Repository",
+    "RepositoryAlreadyExistsError",
+    "RepositoryNotFoundError",
+    "RetrievalArtifact",
+    "SemanticEvaluator",
+    "TokenUsage",
+    "ToolArtifact",
+    "__version__",
+    "artifact_from_dict",
+    "compute_blob_hash",
+    "from_anthropic",
+    "from_crewai",
+    "from_langchain",
+    "from_llamaindex",
+    "from_openai",
+    "init",
+    "open",
+    "record",
+    "track",
+]

evolution_sdk-0.8.0/evolution/adapters/__init__.py

@@ -0,0 +1,28 @@
+"""
+Evolution framework adapters package.
+"""
+
+from evolution.adapters.base import BaseAdapter
+from evolution.adapters.crewai import CrewAIAdapter, from_crewai
+from evolution.adapters.direct import (
+    AnthropicAdapter,
+    OpenAIAdapter,
+    from_anthropic,
+    from_openai,
+)
+from evolution.adapters.langchain import LangChainAdapter, from_langchain
+from evolution.adapters.llamaindex import LlamaIndexAdapter, from_llamaindex
+
+__all__ = [
+    "AnthropicAdapter",
+    "BaseAdapter",
+    "CrewAIAdapter",
+    "LangChainAdapter",
+    "LlamaIndexAdapter",
+    "OpenAIAdapter",
+    "from_anthropic",
+    "from_crewai",
+    "from_langchain",
+    "from_llamaindex",
+    "from_openai",
+]

evolution_sdk-0.8.0/evolution/adapters/base.py

@@ -0,0 +1,21 @@
+"""
+Base protocol and abstract class for framework adapters.
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+from evolution.models.manifest import Manifest
+
+
+class BaseAdapter(ABC):
+    """Abstract base class for converting framework-specific AI configurations
+    into standard Intelligence Manifests (Spec v1.0).
+    """
+
+    @abstractmethod
+    def to_manifest(self, obj: Any, name: str = "ai-intelligence", description: str = "") -> Manifest:
+        """Converts a framework-specific object into an Evolution Manifest."""
+        pass