pyscn-marketplace
Code quality analysis for Python in the age of AI coding.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ludo-technologies/pyscn with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ludo-technologies/pyscn'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/ludo-technologies--pyscn)HTML
<a href="/listings/ludo-technologies--pyscn"><img src="/api/listings/ludo-technologies--pyscn/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# Run analysis without installation uvx pyscn@latest analyze . # or pipx run pyscn analyze .
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 16 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "pyscn-marketplace",
- "owner": {
- "name": "Ludo Technologies"
- },
- "metadata": {
- "description": "Python code quality analysis tools"
- },
- "plugins": [
- {
- "name": "pyscn-mcp",
- "source": "./.claude-plugin/pyscn-mcp",
- "description": "Python code quality analysis with complexity, dead code, clone detection, and coupling metrics"
- }
- ]
- }
README.md · README · 225 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- [English](README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [Français](README.fr.md)
- <br>
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="assets/logo.svg">
- <source media="(prefers-color-scheme: light)" srcset="assets/logo-light.svg">
- <img alt="pyscn" src="assets/logo-light.svg" width="320">
- </picture>
- **Code quality analysis for Python in the age of AI coding.**
- Building with Cursor, Claude, or ChatGPT? pyscn keeps AI-generated code maintainable with structural analysis.
- [](https://dev.to/daisukeyoda/pyscn-the-code-quality-analyzer-for-vibe-coders-18hk)
- [](https://pypi.org/project/pyscn/)
- [](https://pypi.org/project/pyscn/)
- [](https://go.dev/)
- [](LICENSE)
- <a href="https://github.com/apps/polyscan-app/installations/select_target"><img alt="Install Polyscan App for free" src="https://img.shields.io/badge/Polyscan_App-Install_for_free-2ea44f?style=for-the-badge&logo=github&logoColor=white" height="44"></a>
- </div>
- ## Quick Start
- ```bash
- # Run analysis without installation
- uvx pyscn@latest analyze .
- # or
- pipx run pyscn analyze .
- ```
- ## Demo
- <img alt="pyscn analysis report" src="https://raw.githubusercontent.com/ludo-technologies/pyscn/main/assets/demo-report.png" width="720">
- ## Features
- One command scores your whole codebase (0-100 with an A-F grade) and generates an HTML report that shows what to fix first.
- pyscn looks at your code from five angles:
- - 🧹 **Dead code** - unreachable code you can safely delete
- - 📋 **Duplicate code** - copy-pasted and structurally similar code worth merging (Type 1-4 clone detection)
- - 🌀 **Complexity** - functions and executable class suites that are hard to read and test (cyclomatic and cognitive complexity)
- - 🔥 **Module and directory hotspots** - per-file quality and per-directory complexity rollups for prioritizing refactors
- - 🏗️ **Architecture** - circular imports, layer rule violations (clean / layered / hexagonal / MVC presets), and auto-detected module communities that reveal how your code is actually structured
- - 🧩 **Class design** - classes that do too much or depend on too much (CBO coupling, LCOM4 cohesion)
- **100,000+ lines/sec** • Built with Go + tree-sitter
- ## Other Languages
- pyscn is the Python analyzer of [polyscan](https://github.com/ludo-technologies/polyscan). For JavaScript, TypeScript, Go, Rust and C++, run:
- ```bash
- npx polyscan analyze .
- ```
- Same five angles, same 0-100 score, one HTML report.
- ## Polyscan for GitHub
- [Polyscan App](https://github.com/apps/polyscan-app/installations/select_target) files a weekly audit report as a GitHub Issue. Free for public repositories.
- <a href="https://github.com/apps/polyscan-app/installations/select_target"><img alt="Install Polyscan App for free" src="https://img.shields.io/badge/Polyscan_App-Install_for_free-2ea44f?style=for-the-badge&logo=github&logoColor=white" height="44"></a>
- ## AI Agent Integration
- pyscn ships Agent Skills that teach AI coding agents when and how to run each analysis: health checks, refactoring, architecture review, and CI-friendly reports.
- ### Agent Skills (Recommended)
- ```bash
- uvx add-skills ludo-technologies/pyscn
- ```
- This installs the Skills into your project. They work with Claude Code, Cursor, Codex, Gemini CLI, and [many other agents](https://github.com/ludo-technologies/add-skills) (add `--agent cursor` etc. to target one, `--global` for all projects).
- Then just ask your agent:
- 1. "Analyze the code quality of the app/ directory"
- 2. "Find duplicate code and help me refactor it"
- 3. "Show me complex code and help me simplify it"
- ### MCP Server (Optional)
- For tighter integration, the bundled `pyscn-mcp` server exposes the same analyses as MCP tools to Claude Code, Cursor, ChatGPT, and other MCP clients.
- **Claude Code plugin (sets up the MCP server and the Skills together):**
- ```bash
- claude plugin marketplace add ludo-technologies/pyscn
- claude plugin install pyscn-mcp@pyscn-marketplace
- ```
- **Manual setup for Claude Code:**
- ```bash
- claude mcp add pyscn-mcp uvx -- pyscn-mcp
- ```
- **Cursor / Claude Desktop:** add to your MCP settings (`~/.config/claude-desktop/config.json` or Cursor settings):
- ```json
- {
- "mcpServers": {
- "pyscn-mcp": {
- "command": "uvx",
- "args": ["pyscn-mcp"],
- "env": {
- "PYSCN_CONFIG": "/path/to/.pyscn.toml"
- }
- }
- }
- }
- ```
- Dive deeper in `mcp/README.md` for setup walkthroughs and `docs/MCP_INTEGRATION.md` for architecture details.
- ## Installation
- ```bash
- # Install with pipx (recommended)
- pipx install pyscn
- # Or with uv
- uv tool install pyscn
- ```
- > **macOS Intel (x86_64):** PyPI wheels are built for Apple Silicon only (the Intel wheel was dropped in v1.5.1), so `uvx`, `pipx`, `uv`, and `pip` cannot install pyscn on Intel Macs. Use `brew install pyscn` or `go install github.com/ludo-technologies/pyscn/cmd/pyscn@latest` instead.
- <details>
- <summary>Alternative installation methods</summary>
- ### Build from source
- ```bash
- git clone https://github.com/ludo-technologies/pyscn.git
- cd pyscn
- make build
- ```
- ### Go install
- ```bash
- go install github.com/ludo-technologies/pyscn/cmd/pyscn@latest
- ```
- </details>
- ## Common Commands
- ### `pyscn analyze`
- Run comprehensive analysis with HTML report
- ```bash
- pyscn analyze . # All analyses with HTML report
- pyscn analyze --json . # Generate JSON report
- pyscn analyze --json --output - . | jq # JSON report on stdout
- pyscn analyze --json --html --no-open . # JSON and HTML reports from one run
- pyscn analyze --select complexity . # Only complexity analysis
- pyscn analyze --select deps . # Only dependency analysis
- pyscn analyze --select complexity,deps,deadcode . # Multiple analyses
- pyscn analyze --skip-communities . # Skip module community detection
- ```
- ### `pyscn check`
- Fast CI-friendly quality gate
- ```bash
- pyscn check . # Quick pass/fail check
- pyscn check --max-complexity 15 . # Custom thresholds
- pyscn check --max-cycles 0 . # Only allow 0 cycle dependency
- pyscn check --select deps . # Check only for circular dependencies
- pyscn check --select di . # Detect DI anti-patterns (opt-in)
- pyscn check --allow-circular-deps . # Allow circular dependencies (warning only)
- ```
- ### `pyscn init`
- Create configuration file
- ```bash
- pyscn init # Generate .pyscn.toml
- ```
- > 💡 Run `pyscn --help` or `pyscn <command> --help` for complete options
- ## Configuration
- Create a `.pyscn.toml` file or add `[tool.pyscn]` to your `pyproject.toml`:
- ```toml
- # .pyscn.toml
- [complexity]
- max_complexity = 15
- [dead_code]
- min_severity = "warning"
- [output]
- directory = "reports"
- ```
- > ⚙️ Run `pyscn init` to generate a full configuration file with all available options
- ---
- ## Documentation
- 📖 **[pyscn documentation site](https://docs.codescan.dev/pyscn/)** — installation, rule catalog, CLI reference, configuration, output specification
- For contributors: **[Development Guide](docs/DEVELOPMENT.md)** • **[Architecture](docs/ARCHITECTURE.md)** • **[Testing](docs/TESTING.md)**
- ## Enterprise Support
- For commercial support, custom integrations, or consulting services, contact us at contact@ludo-tech.org
- ## License
- MIT License — see [LICENSE](LICENSE)
- ---
- *Built with ❤️ using Go and tree-sitter*
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.