Skip to main content

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.

Python 3.9+ MIT License Code Quality

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 paths
  • WorkflowPathFinder - Discover optimal workflow paths
  • WorkflowRiskCalculator - Assess risks in workflow execution

Code Quality:

  • InsightCategorizer - Categorize insights by phase and workflow
  • DependencyValidator - Validate project dependencies
  • SyntaxValidator - Validate code syntax
  • TestExecutor - Execute and track test results

Data Models:

  • ProjectContext - Complete project information and state
  • TeamMemberRole - Team member roles and skills
  • WorkflowDefinition - Workflow paths and execution states

Analytics:

  • analytics_calculator.AnalyticsCalculator - Calculate metrics from project data
  • maturity_calculator.MaturityCalculator - Assess project maturity
  • TokenUsage - 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 assessment
  • socratic-nexus>=0.3.6 - Multi-provider LLM integration

Optional:

  • langchain>=0.1.0 - LangChain integration
  • langgraph>=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

Part of the Socratic Ecosystem

Socratic Analyzer integrates with:

Contributing

Contributions welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - See LICENSE for details.

Support


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)

Source distribution for socratic-analyzer 0.1.10
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)

Table of built distributions (wheels) for socratic-analyzer 0.1.10
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page