socratic-learning 0.1.0__tar.gz

socratic_learning-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Socratic Learning Contributors
+
+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.

socratic_learning-0.1.0/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: socratic-learning
+Version: 0.1.0
+Summary: Continuous learning system that tracks agent interactions, detects patterns, and provides improvement recommendations.
+Author: Socratic Learning Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Nireus79/Socratic-learning
+Project-URL: Repository, https://github.com/Nireus79/Socratic-learning
+Project-URL: Documentation, https://github.com/Nireus79/Socratic-learning#readme
+Project-URL: Issues, https://github.com/Nireus79/Socratic-learning/issues
+Keywords: learning,tracking,agent,pattern-detection,recommendations,fine-tuning,analytics,socratic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: agents
+Requires-Dist: socratic-agents>=0.1.0; extra == "agents"
+Provides-Extra: nexus
+Requires-Dist: socrates-nexus>=0.3.0; extra == "nexus"
+Provides-Extra: openclaw
+Provides-Extra: langchain
+Requires-Dist: langchain>=0.1.0; extra == "langchain"
+Provides-Extra: all
+Requires-Dist: socratic-agents>=0.1.0; extra == "all"
+Requires-Dist: socrates-nexus>=0.3.0; extra == "all"
+Requires-Dist: langchain>=0.1.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Dynamic: license-file
+
+# Socratic Learning
+
+[![PyPI version](https://badge.fury.io/py/socratic-learning.svg)](https://badge.fury.io/py/socratic-learning)
+[![Tests](https://github.com/Nireus79/Socratic-learning/workflows/Tests/badge.svg)](https://github.com/Nireus79/Socratic-learning/actions)
+[![Code Quality](https://github.com/Nireus79/Socratic-learning/workflows/Code%20Quality/badge.svg)](https://github.com/Nireus79/Socratic-learning/actions)
+
+A continuous learning system for AI agents that tracks interactions, detects patterns, and provides data-driven improvement recommendations.
+
+## Features
+
+- **Interaction Tracking** - Capture and store all agent interactions with context
+- **Pattern Detection** - Identify recurring patterns in agent behaviors and LLM outputs
+- **Performance Metrics** - Monitor agent effectiveness with success rates, response times, costs
+- **User Feedback Integration** - Collect and analyze user feedback on agent responses
+- **Learning Recommendations** - Generate actionable improvement suggestions
+- **Fine-Tuning Export** - Export interaction data for model fine-tuning
+- **Analytics & Reporting** - JSON-based insights and metrics
+- **Framework Integration** - Works with Openclaw and LangChain
+
+## Installation
+
+```bash
+# Core package
+pip install socratic-learning
+
+# With Socratic Agents integration
+pip install socratic-learning[agents]
+
+# With all optional dependencies
+pip install socratic-learning[all]
+
+# For development
+pip install socratic-learning[dev]
+```
+
+## Quick Start
+
+```python
+from socratic_learning import LearningManager
+from socratic_agents import SocraticCounselor
+
+# Initialize learning manager
+learning = LearningManager(storage="sqlite", db_path="learning.db")
+
+# Create a tracking session
+session_id = learning.create_session(
+    user_id="user123",
+    context={"environment": "production"}
+)
+
+# Track agent interactions
+counselor = SocraticCounselor()
+result = counselor.guide("recursion", level="beginner")
+
+learning.track_interaction(
+    session_id=session_id,
+    agent_name="SocraticCounselor",
+    input_data={"topic": "recursion", "level": "beginner"},
+    output_data=result,
+    model_name="claude-opus-4",
+    provider="anthropic",
+    input_tokens=150,
+    output_tokens=500,
+    duration_ms=1200.0,
+)
+
+# Add user feedback
+learning.add_feedback(
+    interaction_id=interaction.interaction_id,
+    rating=5,
+    feedback="Very helpful explanation!"
+)
+
+# Get metrics
+metrics = learning.get_metrics(agent_name="SocraticCounselor")
+print(f"Success rate: {metrics.success_rate}%")
+print(f"Avg rating: {metrics.avg_rating}/5")
+
+# Detect patterns
+patterns = learning.detect_patterns(agent_name="SocraticCounselor")
+for pattern in patterns:
+    print(f"Pattern: {pattern.name} (confidence: {pattern.confidence})")
+
+# Get recommendations
+recommendations = learning.get_recommendations(agent_name="SocraticCounselor")
+for rec in recommendations:
+    print(f"Recommendation: {rec.title}")
+
+# Export for fine-tuning
+learning.export_for_finetuning(
+    output_path="finetuning_data.jsonl",
+    agent_name="SocraticCounselor",
+    min_rating=4,
+    format="openai"
+)
+```
+
+## Core Concepts
+
+### Interaction
+Represents a single agent interaction with input, output, performance metrics, and optional user feedback.
+
+### Pattern
+A detected recurring pattern in agent behaviors (e.g., error patterns, topic-specific behaviors).
+
+### Metric
+Aggregated performance metrics (success rate, average response time, user satisfaction, costs).
+
+### Recommendation
+An actionable improvement suggestion based on detected patterns and metrics.
+
+## Architecture
+
+- **Core Models** - Dataclass-based models with serialization
+- **Storage Layer** - Abstract interface with SQLite backend
+- **Tracking** - Interaction logger with session management
+- **Analytics** - Pattern detection and metrics collection
+- **Integrations** - Openclaw skills and LangChain tools
+
+## Documentation
+
+See [examples/](examples/) for complete working examples.
+
+## Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=src/socratic_learning --cov-report=html
+
+# Run specific test file
+pytest tests/unit/test_models.py -v
+```
+
+## Code Quality
+
+```bash
+# Format with Black
+black src/ tests/
+
+# Lint with Ruff
+ruff check src/ tests/
+
+# Type check with MyPy
+mypy src/
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or submit a PR.
+
+## Status
+
+**Phase 1** - Core foundation complete (v0.1.0 development)
+- ✅ Core data models
+- ✅ SQLite storage
+- ✅ Unit tests
+- 🚀 Phase 2-6 planned

socratic_learning-0.1.0/README.md

@@ -0,0 +1,164 @@
+# Socratic Learning
+
+[![PyPI version](https://badge.fury.io/py/socratic-learning.svg)](https://badge.fury.io/py/socratic-learning)
+[![Tests](https://github.com/Nireus79/Socratic-learning/workflows/Tests/badge.svg)](https://github.com/Nireus79/Socratic-learning/actions)
+[![Code Quality](https://github.com/Nireus79/Socratic-learning/workflows/Code%20Quality/badge.svg)](https://github.com/Nireus79/Socratic-learning/actions)
+
+A continuous learning system for AI agents that tracks interactions, detects patterns, and provides data-driven improvement recommendations.
+
+## Features
+
+- **Interaction Tracking** - Capture and store all agent interactions with context
+- **Pattern Detection** - Identify recurring patterns in agent behaviors and LLM outputs
+- **Performance Metrics** - Monitor agent effectiveness with success rates, response times, costs
+- **User Feedback Integration** - Collect and analyze user feedback on agent responses
+- **Learning Recommendations** - Generate actionable improvement suggestions
+- **Fine-Tuning Export** - Export interaction data for model fine-tuning
+- **Analytics & Reporting** - JSON-based insights and metrics
+- **Framework Integration** - Works with Openclaw and LangChain
+
+## Installation
+
+```bash
+# Core package
+pip install socratic-learning
+
+# With Socratic Agents integration
+pip install socratic-learning[agents]
+
+# With all optional dependencies
+pip install socratic-learning[all]
+
+# For development
+pip install socratic-learning[dev]
+```
+
+## Quick Start
+
+```python
+from socratic_learning import LearningManager
+from socratic_agents import SocraticCounselor
+
+# Initialize learning manager
+learning = LearningManager(storage="sqlite", db_path="learning.db")
+
+# Create a tracking session
+session_id = learning.create_session(
+    user_id="user123",
+    context={"environment": "production"}
+)
+
+# Track agent interactions
+counselor = SocraticCounselor()
+result = counselor.guide("recursion", level="beginner")
+
+learning.track_interaction(
+    session_id=session_id,
+    agent_name="SocraticCounselor",
+    input_data={"topic": "recursion", "level": "beginner"},
+    output_data=result,
+    model_name="claude-opus-4",
+    provider="anthropic",
+    input_tokens=150,
+    output_tokens=500,
+    duration_ms=1200.0,
+)
+
+# Add user feedback
+learning.add_feedback(
+    interaction_id=interaction.interaction_id,
+    rating=5,
+    feedback="Very helpful explanation!"
+)
+
+# Get metrics
+metrics = learning.get_metrics(agent_name="SocraticCounselor")
+print(f"Success rate: {metrics.success_rate}%")
+print(f"Avg rating: {metrics.avg_rating}/5")
+
+# Detect patterns
+patterns = learning.detect_patterns(agent_name="SocraticCounselor")
+for pattern in patterns:
+    print(f"Pattern: {pattern.name} (confidence: {pattern.confidence})")
+
+# Get recommendations
+recommendations = learning.get_recommendations(agent_name="SocraticCounselor")
+for rec in recommendations:
+    print(f"Recommendation: {rec.title}")
+
+# Export for fine-tuning
+learning.export_for_finetuning(
+    output_path="finetuning_data.jsonl",
+    agent_name="SocraticCounselor",
+    min_rating=4,
+    format="openai"
+)
+```
+
+## Core Concepts
+
+### Interaction
+Represents a single agent interaction with input, output, performance metrics, and optional user feedback.
+
+### Pattern
+A detected recurring pattern in agent behaviors (e.g., error patterns, topic-specific behaviors).
+
+### Metric
+Aggregated performance metrics (success rate, average response time, user satisfaction, costs).
+
+### Recommendation
+An actionable improvement suggestion based on detected patterns and metrics.
+
+## Architecture
+
+- **Core Models** - Dataclass-based models with serialization
+- **Storage Layer** - Abstract interface with SQLite backend
+- **Tracking** - Interaction logger with session management
+- **Analytics** - Pattern detection and metrics collection
+- **Integrations** - Openclaw skills and LangChain tools
+
+## Documentation
+
+See [examples/](examples/) for complete working examples.
+
+## Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=src/socratic_learning --cov-report=html
+
+# Run specific test file
+pytest tests/unit/test_models.py -v
+```
+
+## Code Quality
+
+```bash
+# Format with Black
+black src/ tests/
+
+# Lint with Ruff
+ruff check src/ tests/
+
+# Type check with MyPy
+mypy src/
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or submit a PR.
+
+## Status
+
+**Phase 1** - Core foundation complete (v0.1.0 development)
+- ✅ Core data models
+- ✅ SQLite storage
+- ✅ Unit tests
+- 🚀 Phase 2-6 planned

socratic_learning-0.1.0/pyproject.toml

@@ -0,0 +1,105 @@
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "socratic-learning"
+version = "0.1.0"
+description = "Continuous learning system that tracks agent interactions, detects patterns, and provides improvement recommendations."
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "Socratic Learning Contributors"}
+]
+keywords = [
+    "learning",
+    "tracking",
+    "agent",
+    "pattern-detection",
+    "recommendations",
+    "fine-tuning",
+    "analytics",
+    "socratic",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.9"
+
+dependencies = [
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+agents = ["socratic-agents>=0.1.0"]
+nexus = ["socrates-nexus>=0.3.0"]
+openclaw = []
+langchain = ["langchain>=0.1.0"]
+
+all = [
+    "socratic-agents>=0.1.0",
+    "socrates-nexus>=0.3.0",
+    "langchain>=0.1.0",
+]
+
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0",
+    "black>=23.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Nireus79/Socratic-learning"
+Repository = "https://github.com/Nireus79/Socratic-learning"
+Documentation = "https://github.com/Nireus79/Socratic-learning#readme"
+Issues = "https://github.com/Nireus79/Socratic-learning/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages]
+find = {where = ["src"]}
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+markers = [
+    "unit: Unit tests",
+    "integration: Integration tests",
+]
+addopts = "-v --strict-markers"
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = false
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+ignore_missing_imports = true
+follow_imports = "silent"

socratic_learning-0.1.0/setup.cfg

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

socratic_learning-0.1.0/src/socratic_learning/__init__.py

@@ -0,0 +1,21 @@
+"""Socratic Learning - Continuous learning system for AI agents."""
+
+from socratic_learning.analytics import MetricsCollector, PatternDetector
+from socratic_learning.core import Interaction, Metric, Pattern, Recommendation
+from socratic_learning.storage import BaseLearningStore, SQLiteLearningStore
+from socratic_learning.tracking import InteractionLogger, Session
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Interaction",
+    "Pattern",
+    "Metric",
+    "Recommendation",
+    "BaseLearningStore",
+    "SQLiteLearningStore",
+    "Session",
+    "InteractionLogger",
+    "MetricsCollector",
+    "PatternDetector",
+]

socratic_learning-0.1.0/src/socratic_learning/analytics/__init__.py

@@ -0,0 +1,13 @@
+"""Analytics and metrics for Socratic Learning."""
+
+from socratic_learning.analytics.aggregator import DataAggregator
+from socratic_learning.analytics.metrics_collector import MetricsCollector
+from socratic_learning.analytics.pattern_detector import PatternDetector
+from socratic_learning.analytics.reporter import ReportGenerator
+
+__all__ = [
+    "MetricsCollector",
+    "PatternDetector",
+    "DataAggregator",
+    "ReportGenerator",
+]