Repository intelligence
Health Report: litellm
Quick Insights
Key findings from the analysis - prioritized by impact
Technical Debt Hotspot
Found 157 critical and 275 high-priority debt items. These are areas where the team has explicitly noted problems. Consider scheduling time to address the most impactful items.
Low Cohesion Classes
Detected 11 classes with low cohesion (LCOM > 50). These classes may be doing too many unrelated things. Consider splitting them into more focused components.
Active Development
71076 commits across 6644 files.
Healthy Codebase
Overall health score of 86 indicates a well-maintained codebase. Continue current practices and address issues as they arise.
Hotspots
Files with both high complexity and frequent changes - highest risk for bugs
Risk Landscape
Files in the upper-right are both complex and frequently changed -- the most likely sources of bugs. Bubble size reflects overall risk score. Green is low risk, yellow moderate, red high.
| File | Lang | Risk | Changes | Complexity |
|---|
Low Cohesion Classes
Classes doing too many unrelated things - candidates for splitting
| Class | File | Language | LCOM | WMC | CBO |
|---|
Architectural Smells
Structural problems that make the codebase harder to change safely
| Type | Severity | Files Involved | Suggestion |
|---|---|---|---|
| Cyclic Dependency | Critical | .../ust/crates/core/src/messages/types.rs, .../s/core/src/messages/transformation.rs | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | .../s/_components/IndexesTableColumns.tsx, .../r-stores/_components/IndexesTable.tsx, .../tor-stores/_components/IndexesTab.tsx | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | .../d_model/complexity_router_keywords.ts, .../onents/add_model/KeywordTierRules.tsx | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | .../s/fetch_available_models_team_key.tsx, .../components/llm_calls/fetch_models.tsx, .../add_model/SemanticKeywordMatching.tsx, .../_model/ClassificationMethodConfig.tsx, .../s/add_model/AdaptiveRoutingConfig.tsx, ...//add_model/ComplexityRouterConfig.tsx, .../del/build_complexity_router_config.ts, .../n_components/check_openapi_schema.tsx, .../ponents/key_team_helpers/key_list.tsx, .../shboard/src/components/networking.tsx | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | ...//PassThroughEndpointsTableColumns.tsx, .../ettings/PassThroughEndpointsTable.tsx, .../d/src/components/add_pass_through.tsx, .../roughSettings/PassThroughSettings.tsx | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | .../src/components/team/TeamMemberTab.tsx, .../oard/src/components/team/TeamInfo.tsx | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | .../d/src/data/claimsCompliancePrompts.ts, ...//data/canadianPiiCompliancePrompts.ts, .../ata/codeExecutionCompliancePrompts.ts, .../rc/data/financialCompliancePrompts.ts, ...//src/data/insultsCompliancePrompts.ts, .../shboard/src/data/compliancePrompts.ts | Break the cycle by introducing an interface or restructuring the dependency direction |
| Cyclic Dependency | Critical | .../pareUI/components/ComparisonPanel.tsx, .../nd/components/compareUI/CompareUI.tsx | Break the cycle by introducing an interface or restructuring the dependency direction |
| Central Connector | Critical | .../shboard/src/components/networking.tsx | Decompose into smaller components with single responsibility; extract interfaces for consumers |
| Hub Dependency | High | .../ponents/molecules/message_manager.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../s/molecules/notifications_manager.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../oard/src/components/team/TeamInfo.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../rc/components/molecules/logo/Logo.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../ard/src/app/(dashboard)/networking.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../pp/(dashboard)/hooks/useAuthorized.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../dashboard/src/components/ui/badge.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | ...//components/ui/ui-loading-spinner.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | tests/e2e/ui/helpers/navigation.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../rc/components/AIHub/ModelHubTable.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../nents/organisms/create_key_button.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../d/src/components/ui/dropdown-menu.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../ard)/hooks/common/queryKeysFactory.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../-dashboard/src/components/ui/card.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../yground/components/chat_ui/ChatUI.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../dashboard/src/components/ui/input.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../m-dashboard/src/components/navbar.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../onents/shared/DataTable/DataTable.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../on_components/DeleteResourceModal.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | ...//components/provider_info_helpers.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../app/(dashboard)/hooks/keys/useKeys.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../oks/organizations/useOrganizations.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | litellm/proxy/auth/roles.py | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../ashboard/src/components/ui/button.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../-dashboard/src/components/leftnav.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | tests/e2e/ui/constants.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../(dashboard)/hooks/models/useModels.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../hboard)/hooks/projects/useProjects.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../tellm-dashboard/src/lib/cva.config.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../components/llm_calls/fetch_models.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../ponents/key_team_helpers/key_list.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../omponents/templates/key_info_view.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../rvers/_components/CreateMCPServer.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../ts/organization/organization_view.tsx | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../ellm-dashboard/src/utils/dataUtils.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../p/(dashboard)/hooks/teams/useTeams.ts | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | litellm/files/types.py | Consider splitting this component into smaller, more focused modules |
| Hub Dependency | High | .../itellm-dashboard/tests/test-utils.tsx | Consider splitting this component into smaller, more focused modules |
Dependency Structure
Import graph analysis - cycles, bottlenecks, and instability
Detected Cycles
litellm-rust/crates/core/src/messages/types.rs→.../rust/crates/core/src/messages/transformation.rs→litellm-rust/crates/core/src/messages/types.rs.../ctor-stores/_components/IndexesTableColumns.tsx→.../ard)/vector-stores/_components/IndexesTable.tsx→.../board)/vector-stores/_components/IndexesTab.tsx→.../ctor-stores/_components/IndexesTableColumns.tsx.../ponents/add_model/complexity_router_keywords.ts→.../d/src/components/add_model/KeywordTierRules.tsx→.../ponents/add_model/complexity_router_keywords.ts.../eam_helpers/fetch_available_models_team_key.tsx→.../board/src/components/llm_calls/fetch_models.tsx→.../omponents/add_model/SemanticKeywordMatching.tsx→.../onents/add_model/ClassificationMethodConfig.tsx→...//components/add_model/AdaptiveRoutingConfig.tsx→.../components/add_model/ComplexityRouterConfig.tsx→.../nts/add_model/build_complexity_router_config.ts→.../ents/common_components/check_openapi_schema.tsx→.../rd/src/components/key_team_helpers/key_list.tsx→ui/litellm-dashboard/src/components/networking.tsx→.../eam_helpers/fetch_available_models_team_key.tsx.../ghSettings/PassThroughEndpointsTableColumns.tsx→.../ssThroughSettings/PassThroughEndpointsTable.tsx→.../m-dashboard/src/components/add_pass_through.tsx→.../nts/PassThroughSettings/PassThroughSettings.tsx→.../ghSettings/PassThroughEndpointsTableColumns.tsx.../dashboard/src/components/team/TeamMemberTab.tsx→.../ellm-dashboard/src/components/team/TeamInfo.tsx→.../dashboard/src/components/team/TeamMemberTab.tsx.../m-dashboard/src/data/claimsCompliancePrompts.ts→.../hboard/src/data/canadianPiiCompliancePrompts.ts→.../oard/src/data/codeExecutionCompliancePrompts.ts→.../ashboard/src/data/financialCompliancePrompts.ts→.../-dashboard/src/data/insultsCompliancePrompts.ts→ui/litellm-dashboard/src/data/compliancePrompts.ts→.../m-dashboard/src/data/claimsCompliancePrompts.ts.../onents/compareUI/components/ComparisonPanel.tsx→.../)/playground/components/compareUI/CompareUI.tsx→.../onents/compareUI/components/ComparisonPanel.tsx| File | Lang | PageRank | Betweenness | In | Out | Instability |
|---|
Known Issues
Problems the team has documented but not yet fixed (TODO, FIXME, HACK)
By Severity
By Category
| Severity | Category | File | Lang | Line | Comment |
|---|
Duplicated Code
Code that appears in multiple places - bugs fixed in one spot may need fixing elsewhere
Duplication Level
Technical Debt Gradient
Per-file debt scores - prioritize cleanup where it matters most
Grade Distribution
| File | Lang | Score | Grade | Structural | Semantic | Duplication | Coupling |
|---|
Historical Trends
How code quality has changed over time
Health Score Over Time
Component Trends
Change Activity
How frequently code is being modified
| File | Lang | Changes | Contributors | Churn Score |
|---|
Code Ownership
How knowledge is distributed - concentrated knowledge is a risk
Top Contributors
Temporal Coupling
Files that frequently change together - reveals hidden dependencies not in the import graph
| File A | File B | Co-changes | Strength |
|---|
Score Breakdown
How the health score is calculated from individual components
Glossary
Definitions for the quality and risk terminology used in this report
Glossary of Terms
▼Health Score
A weighted composite metric (0-100) measuring overall code quality. Above 80 is good, 60-80 needs attention, below 60 is concerning.
Hotspot
A file that is both complex AND frequently changed. These are the highest-risk areas because they're hard to change safely but get changed often.
Bus Factor
The minimum number of people who would need to leave before critical knowledge is lost. Higher is better; 1 is a serious risk.
Knowledge Silo
A file that only one person has ever touched. If that person leaves, the knowledge goes with them.
Cyclomatic Complexity
The number of independent paths through code. More paths means more test cases needed and more ways things can go wrong.
Cognitive Complexity
How hard code is to understand. Accounts for nesting, breaks in flow, and things that make humans struggle to follow the logic.
LCOM (Cohesion)
How well a class's methods work together. High LCOM means methods don't share data - the class is probably doing too many unrelated things.
CBO (Coupling)
How many other classes a class depends on. High coupling means changes ripple through the codebase - everything is connected to everything.
Churn Rate
How frequently a file changes. High churn indicates instability - the code may be unclear, have bugs, or be undergoing active development.
Self-Admitted Technical Debt (SATD)
Code issues the team has documented (TODO, FIXME, HACK, XXX). These represent known shortcuts that need eventual attention.
Code Clone / Duplicate
Similar code appearing in multiple places. When a bug is fixed in one spot, it may need fixing elsewhere. Candidates for refactoring into shared functions.
Technical Debt Gradient
Per-file quality score (0-100) combining complexity, duplication, coupling, and other factors. Lower scores mean more accumulated debt.
Temporal Coupling
Files that frequently change together in the same commits. High temporal coupling suggests hidden dependencies not visible in the import graph.
Architectural Smell
A structural pattern that violates design principles: cyclic dependencies, hub-like modules, or stable code depending on unstable code.
Instability
Ratio of outgoing to total dependencies. 0 = maximally stable (many things depend on it), 1 = maximally unstable (depends on many things).
PageRank
Importance of a file in the dependency graph. Files with high PageRank are depended on by many other important files.