Proof of concept, not a product. This library belongs to the earlier Python research prototype (Socrates) and is not maintained as a product. The current products are listed at nireus79.github.io. Contact: Hermes_creative@proton.me.
Socratic Analyzer
Status: Independent library extracted from Socrates monolith (v0.1.5)
Code analysis and workflow optimization library for project development, quality assessment, and architectural insights. Part of the Socratic Ecosystem.
Overview
Socratic Analyzer provides tools for analyzing project workflows, assessing code complexity, tracking maturity, and identifying optimization opportunities.
Key Capabilities
- Workflow Analysis - Analyze project workflows and process paths
- Complexity Metrics - Calculate workflow costs and identify bottlenecks
- Code Validation - Validate dependencies, syntax, and test execution
- Project Context - Model projects with phases, team structure, and maturity tracking
- Quality Assessment - Track project maturity across phases and categories
- Insight Categorization - Categorize insights and recommendations by workflow phase
Architecture
Core Modules
Workflow Analysis:
WorkflowCostCalculator- Calculate execution costs of workflow pathsWorkflowPathFinder- Discover optimal workflow pathsWorkflowRiskCalculator- Assess risks in workflow execution
Code Quality:
InsightCategorizer- Categorize insights by phase and workflowDependencyValidator- Validate project dependenciesSyntaxValidator- Validate code syntaxTestExecutor- Execute and track test results
Data Models:
ProjectContext- Complete project information and stateTeamMemberRole- Team member roles and skillsWorkflowDefinition- Workflow paths and execution states
Analytics:
analytics_calculator.AnalyticsCalculator- Calculate metrics from project datamaturity_calculator.MaturityCalculator- Assess project maturityTokenUsage- Track LLM usage and costs
Installation
# Basic installation
pip install socratic-analyzer
# With framework integrations
pip install socratic-analyzer[langchain]
pip install socratic-analyzer[nexus]
# Development
pip install socratic-analyzer[dev]
Dependencies
Core:
socratic-maturity>=0.1.1- Maturity tracking and assessmentsocratic-nexus>=0.3.6- Multi-provider LLM integration
Optional:
langchain>=0.1.0- LangChain integrationlanggraph>=0.0.1- Graph-based workflows
Quick Start
Cost of a workflow path
from socratic_analyzer.core import WorkflowCostCalculator
from socratic_analyzer.models import (
WorkflowDefinition, WorkflowEdge, WorkflowNode, WorkflowPath,
)
from socratic_analyzer.models.workflow import WorkflowNodeType
workflow = WorkflowDefinition(
workflow_id="wf-1",
name="Analysis workflow",
phase="analysis",
nodes={
"start": WorkflowNode("start", WorkflowNodeType.PHASE_START, "Start"),
"review": WorkflowNode("review", WorkflowNodeType.ANALYSIS, "Review", estimated_tokens=500),
"end": WorkflowNode("end", WorkflowNodeType.PHASE_END, "End"),
},
edges=[
WorkflowEdge(from_node="start", to_node="review", cost=10),
WorkflowEdge(from_node="review", to_node="end", cost=5),
],
start_node="start",
end_nodes=["end"],
)
path = WorkflowPath(path_id="p1", nodes=["start", "review", "end"], edges=[])
print(WorkflowCostCalculator().calculate_path_cost(path, workflow))
# {'total_tokens': 500, 'total_cost_usd': 0.0225, 'token_breakdown': {...}}
Validate dependencies
from socratic_analyzer.utils.validators import DependencyValidator
result = DependencyValidator().validate("./requirements.txt")
print(result["valid"], result["issues"], result["warnings"])
validate takes a project directory or a file and returns a dict with valid, issues, warnings and metadata.
Phase maturity
from socratic_analyzer.maturity_calculator import MaturityCalculator
calculator = MaturityCalculator()
print(calculator.get_phase_categories("discovery")) # category -> target points
specs = [{"category": "problem_definition", "confidence": 0.9, "value": 1.0}]
maturity = calculator.calculate_phase_maturity(specs, "discovery")
print(maturity.overall_score, maturity.missing_categories)
The phases are discovery, analysis, design and implementation; the score is the confidence-weighted sum per category, capped at the category target, as a percentage of 90.
Testing
# Run all tests
pytest
# Run with coverage
pytest --cov=src/socratic_analyzer
# Run specific tests
pytest tests/test_module_imports.py -v
Code Quality
All checks passing:
- ✅ Black formatting
- ✅ Ruff linting
- ✅ Mypy type checking (pragmatic for extracted library)
Documentation
- ARCHITECTURE.md - System design and component overview
- API Reference - Complete API documentation (when available)
- Integration Guide - How to integrate with other systems
Part of the Socratic Ecosystem
Socratic Analyzer integrates with:
- Socratic Nexus - Multi-provider LLM client
- Socratic Maturity - Maturity tracking (dependency)
- Socratic Agents - Agent orchestration (optional)
- Socratic Learning - Learning patterns (optional)
Contributing
Contributions welcome! Please see CONTRIBUTING.md for guidelines.
License
MIT License - See LICENSE for details.
Support
- Issues: https://github.com/Nireus79/Socratic-analyzer/issues
- Documentation: https://github.com/Nireus79/Socratic-analyzer/tree/main/docs
Built as part of the Socratic ecosystem
Made by @Nireus79
Origin
This package comes from the Socrates research prototype, which is not maintained as a product. Status: alpha. Written by Efthimios Angelopoulos with AI coding assistants (Claude Code); I design, review and test it. Contact: Hermes_creative@proton.me.
Use This Package Standalone:
pip install socratic-analyzer
Or As Part of Socrates Platform:
pip install socrates-ai # the earlier research prototype that uses this package
More Information:
Metadata
Release files for socratic-analyzer 0.1.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| socratic_analyzer-0.1.10.tar.gz | 60.7 kB | Without provenance | Details for socratic_analyzer-0.1.10.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| socratic_analyzer-0.1.10-py3-none-any.whl | Python 3 | none | any | Details for socratic_analyzer-0.1.10-py3-none-any.whl |
Total release size: 130.9 kB
Release files / socratic_analyzer-0.1.10.tar.gz
| Download URL | socratic_analyzer-0.1.10.tar.gz |
|---|---|
| Size | 60.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b73467fc6cafd1af6a9e3b7f658a9873280572945448ec20bca00d822cae7deb
|
|
BLAKE2b-256 checksum How to use checksums |
49a99029d09c1510c3244a4f69c3ffa83a1eb61cfd984f180c72989f704fcb15
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / socratic_analyzer-0.1.10-py3-none-any.whl
| Download URL | socratic_analyzer-0.1.10-py3-none-any.whl |
|---|---|
| Size | 70.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
30a5630756a0a10579112f011f70deed3382fcc9bed6cfae4aaf92cad8fef150
|
|
BLAKE2b-256 checksum How to use checksums |
29baf4ee3bb022622228a65e90bdefbf88543c1fae6eb612fc43de23432388ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for socratic-analyzer 0.1.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.