Python API Reference

Complete Python API documentation auto-generated from Marcus codebase.

Auto-generated from 161 Python files (~65,000 lines of code).

This documentation is automatically extracted from source code docstrings using Sphinx’s autodoc extension.

Complete Module Reference

• src.ai package
  • MarcusAIEngine
  • LLMAbstraction
  • HybridDecisionFramework
  • HybridAnalysis
  • AnalysisContext
  • AssignmentDecision
  • Subpackages
  • Submodules
• src.ai.advanced package
  • Subpackages
• src.ai.advanced.prd package
  • Submodules
• src.ai.advanced.prd.advanced_parser module
• src.ai.core package
  • MarcusAIEngine
  • HybridAnalysis
  • AnalysisContext
  • Submodules
• src.ai.core.ai_engine module
  • Classes
  • RuleBasedEngine
  • MarcusAIEngine
• src.ai.decisions package
  • HybridDecisionFramework
  • AssignmentDecision
  • Submodules
• src.ai.decisions.hybrid_framework module
  • AIEngine
  • HybridDecisionFramework
• src.ai.enrichment package
  • IntelligentTaskEnricher
  • EnhancementResult
  • Submodules
• src.ai.enrichment.intelligent_enricher module
  • EnhancementResult
  • ProjectContext
  • IntelligentTaskEnricher
• src.ai.learning package
  • ContextualLearningSystem
  • TeamLearnings
  • TechnologyLearnings
  • Submodules
• src.ai.learning.contextual_learner module
  • TeamLearnings
  • TechnologyLearnings
  • ProjectTypeLearnings
  • AdaptedTemplate
  • ContextualLearningSystem
• src.ai.providers package
  • BaseLLMProvider
  • SemanticAnalysis
  • SemanticDependency
  • EffortEstimate
  • CloudLLMProvider
  • LLMAbstraction
  • Submodules
• src.ai.providers.anthropic_provider module
  • AnthropicProvider
• src.ai.providers.base_provider module
  • Classes
  • SemanticAnalysis
  • SemanticDependency
  • EffortEstimate
  • BaseLLMProvider
• src.ai.providers.llm_abstraction module
  • Classes
  • LLMAbstraction
• src.ai.providers.local_provider module
  • Classes
  • LocalLLMProvider
• src.ai.providers.openai_provider module
  • Classes
  • OpenAIProvider
• src.ai.types module
  • Classes
  • AnalysisContext
  • AIInsights
  • HybridAnalysis
  • RuleBasedResult
  • AIOptimizationResult
  • AssignmentDecision
  • AssignmentContext
• src.api package
  • Submodules
• src.api.pattern_learning_init module
• src.config package
  • Key Features
  • Classes
  • Settings
  • Submodules
• src.config.config_loader module
  • ConfigLoader
  • get_config()
  • get_config_value()
  • get_kanban_provider()
  • get_anthropic_api_key()
  • get_planka_config()
• src.config.hybrid_inference_config module
  • HybridInferenceConfig
  • get_preset_config()
• src.config.settings module
  • Settings
• src.core package
  • Submodules
• src.core.adaptive_dependencies module
  • DependencySignal
  • RelationshipPattern
  • DependencyFeedback
  • UserRelationship
  • WorkflowPattern
  • DependencyInterface
  • AdaptiveDependencyInferer
• src.core.ai_powered_task_assignment module
  • AITaskAssignmentEngine
  • find_optimal_task_for_agent_ai_powered()
• src.core.assignment_lease module
  • LeaseStatus
  • AssignmentLease
  • AssignmentLeaseManager
  • LeaseMonitor
• src.core.assignment_persistence module
  • AssignmentPersistence
• src.core.assignment_reconciliation module
  • ReconciliationResults
  • AssignmentHealth
  • AssignmentReconciler
• src.core.board_health_analyzer module
  • HealthIssueType
  • IssueSeverity
  • HealthIssue
  • BoardHealth
  • BoardHealthAnalyzer
• src.core.code_analyzer module
  • CodeAnalyzer
• src.core.context module
  • TaskContext
  • DependentTask
  • Decision
  • Context
• src.core.error_framework module
  • ErrorSeverity
  • ErrorCategory
  • ErrorContext
  • RemediationSuggestion
  • MarcusBaseError
  • TransientError
  • NetworkTimeoutError
  • ServiceUnavailableError
  • RateLimitError
  • TemporaryResourceError
  • ConfigurationError
  • MissingCredentialsError
  • InvalidConfigurationError
  • MissingDependencyError
  • EnvironmentError
  • BusinessLogicError
  • TaskAssignmentError
  • WorkflowViolationError
  • ValidationError
  • StateConflictError
  • TaskValidationError
  • ProjectRootNotFoundError
  • IntegrationError
  • KanbanIntegrationError
  • AIProviderError
  • AuthenticationError
  • ExternalServiceError
  • SecurityError
  • AuthorizationError
  • WorkspaceSecurityError
  • PermissionError
  • SystemError
  • ResourceExhaustionError
  • CorruptedStateError
  • DatabaseError
  • CriticalDependencyError
  • error_context()
  • ErrorResponseFormatter
  • MarcusError
• src.core.error_monitoring module
  • AlertSeverity
  • ErrorMetrics
  • ErrorPattern
  • CorrelationGroup
  • ErrorMonitor
  • setup_error_monitoring()
  • record_error_for_monitoring()
  • get_error_health_status()
• src.core.error_responses module
  • ResponseFormat
  • ErrorResponseConfig
  • ErrorResponseFormatter
  • BatchErrorResponseFormatter
  • create_success_response()
  • create_error_response()
  • handle_mcp_tool_error()
• src.core.error_strategies module
  • Status
  • CircuitBreakerState
  • RetryPolicy
  • RetryConfig
  • CircuitBreakerConfig
  • CircuitBreakerStatus
  • CircuitBreaker
  • RetryHandler
  • FallbackHandler
  • ErrorAggregator
  • with_retry()
  • with_circuit_breaker()
  • with_fallback()
  • ErrorStrategyRegistry
• src.core.event_loop_utils module
  • EventLoopLockManager
  • ThreadLocalLockManager
  • create_event_loop_safe_lock()
• src.core.events module
  • Event
  • Events
  • EventTypes
• src.core.memory module
  • TaskOutcome
  • AgentProfile
  • TaskPattern
  • Memory
• src.core.memory_advanced module
  • MemoryAdvanced
• src.core.models module
  • TaskStatus
  • RiskLevel
  • Priority
  • RecoveryInfo
  • Task
  • ProjectState
  • WorkerStatus
  • TaskAssignment
  • BlockerReport
  • ProjectRisk
• src.core.persistence module
  • PersistenceBackend
  • FilePersistence
  • SQLitePersistence
  • Persistence
  • MemoryPersistence
• src.core.phase_dependency_enforcer module
  • TaskPhase
  • DependencyType
  • FeatureGroup
  • PhaseDependencyEnforcer
• src.core.project_context_manager module
  • ProjectContext
  • ProjectContextManager
• src.core.project_registry module
  • ProjectConfig
  • ProjectRegistry
• src.core.resilience module
  • RetryConfig
  • CircuitBreakerConfig
  • CircuitBreaker
  • with_fallback()
  • with_retry()
  • with_circuit_breaker()
  • GracefulDegradation
  • resilient_persistence()
  • resilient_external_call()
  • resilient_ai_call()
• src.core.service_registry module
  • MarcusServiceRegistry
  • get_service_registry()
  • register_marcus_service()
  • unregister_marcus_service()
• src.core.task_recovery module
• src.core.workspace module
  • WorkspaceSecurityError
  • WorkspaceConfig
  • ProjectWorkspaces
  • WorkspaceManager
• src.cost_tracking package
  • TokenTracker
  • AIUsageMiddleware
  • track_project_tokens()
  • Submodules
• src.cost_tracking.ai_usage_middleware module
  • AIUsageMiddleware
  • track_project_tokens()
• src.cost_tracking.token_tracker module
  • TokenTracker
• src.detection package
  • Submodules
• src.detection.board_analyzer module
  • WorkflowPattern
  • BoardState
  • BoardAnalyzer
• src.detection.context_detector module
  • MarcusMode
  • UserIntent
  • ModeRecommendation
  • UserContext
  • ContextDetector
• src.integrations package
  • Subpackages
  • Submodules
• src.integrations.adaptive_documentation module
  • DocumentationType
  • DocumentationContext
  • AdaptiveDocumentationGenerator
  • create_documentation_context()
• src.integrations.ai_analysis_engine module
  • AIAnalysisEngine
• src.integrations.documentation_tasks module
  • DocumentationTaskGenerator
  • enhance_project_with_documentation()
• src.integrations.enhanced_task_classifier module
  • ClassificationResult
  • EnhancedTaskClassifier
• src.integrations.github_mcp_interface module
  • GitHubMCPInterface
• src.integrations.kanban_client module
  • KanbanClient
• src.integrations.kanban_client_with_create module
  • KanbanClientWithCreate
• src.integrations.kanban_factory module
  • KanbanFactory
• src.integrations.kanban_interface module
  • KanbanProvider
  • KanbanInterface
• src.integrations.label_helper module
  • LabelManagerHelper
  • example_usage()
• src.integrations.nlp_base module
  • NaturalLanguageTaskCreator
• src.integrations.nlp_task_utils module
  • TaskType
  • TaskClassifier
  • TaskBuilder
  • SafetyChecker
• src.integrations.nlp_tools module
• src.integrations.providers package
  • Planka
  • PlankaKanban
  • LinearKanban
  • GitHubKanban
  • SQLiteKanban
  • Submodules
• src.integrations.providers.github_kanban module
  • GitHubKanban
• src.integrations.providers.linear_kanban module
  • LinearKanban
• src.integrations.providers.planka module
  • Planka
• src.integrations.providers.planka_kanban module
  • PlankaKanban
• src.intelligence package
  • Submodules
• src.intelligence.dependency_inferer module
  • DependencyPattern
  • InferredDependency
  • DependencyGraph
  • DependencyInferer
• src.intelligence.dependency_inferer_hybrid module
  • HybridDependency
  • HybridDependencyInferer
• src.intelligence.intelligent_task_generator module
  • TaskTemplate
  • FeatureTaskTemplate
  • TechStackTaskTemplate
  • ProjectStructure
  • ProjectContext
  • TaskDescription
  • IntelligentTaskGenerator
• src.intelligence.prd_parser module
  • PRDFormat
  • Feature
  • TechStack
  • ProjectConstraints
  • ParsedPRD
  • PRDParser
• src.learning package
  • Submodules
• src.learning.pattern_learner module
  • CompletedProject
  • ProjectLearnings
  • Pattern
  • PatternLearner
• src.learning.project_pattern_learner module
  • ProjectPattern
  • TeamPerformanceMetrics
  • ProjectPatternLearner
• src.logging package
  • Modules
  • Classes
  • Functions
  • ConversationLogger
  • ConversationType
  • log_conversation()
  • log_thinking()
  • Submodules
• src.logging.agent_events module
  • log_agent_event()
  • log_conversation_event()
• src.logging.conversation_logger module
  • Classes
  • Functions
  • ConversationType
  • ConversationLogger
  • log_conversation()
  • log_thinking()
• src.marcus_mcp package
  • Subpackages
  • Submodules
• src.marcus_mcp.agent_server module
• src.marcus_mcp.audit module
  • AuditLogger
  • get_audit_logger()
• src.marcus_mcp.client module
  • SimpleMarcusClient
• src.marcus_mcp.client_manager module
• src.marcus_mcp.dual_transport_server module
• src.marcus_mcp.handlers module
• src.marcus_mcp.handlers_fixed module
• src.marcus_mcp.server module
• src.marcus_mcp.tool_groups module
  • get_tools_for_endpoint()
  • is_tool_allowed()
• src.marcus_mcp.tools package
  • Submodules
• src.marcus_mcp.tools.agent module
  • register_agent()
  • get_agent_status()
  • list_registered_agents()
• src.marcus_mcp.tools.analytics module
• src.marcus_mcp.tools.attachment module
  • log_artifact()
• src.marcus_mcp.tools.audit_tools module
• src.marcus_mcp.tools.auth module
• src.marcus_mcp.tools.board_health module
• src.marcus_mcp.tools.code_metrics module
• src.marcus_mcp.tools.context module
  • log_decision()
  • get_task_context()
  • assemble_task_context()
• src.marcus_mcp.tools.nlp module
• src.marcus_mcp.tools.predictions module
• src.marcus_mcp.tools.project module
• src.marcus_mcp.tools.project_management module
• src.marcus_mcp.tools.system module
• src.marcus_mcp.tools.task module
• src.marcus_mcp.utils module
  • MarcusJSONEncoder
  • serialize_for_mcp()
  • safe_serialize_task()
• src.modes package
  • Subpackages
• src.modes.adaptive package
  • Submodules
• src.modes.adaptive.basic_adaptive module
  • BasicAdaptiveMode
• src.modes.creator package
  • Submodules
• src.modes.creator.basic_creator module
  • BasicCreatorMode
• src.modes.creator.task_generator module
  • TaskGenerator
• src.modes.creator.template_library module
  • ProjectSize
  • TaskTemplate
  • PhaseTemplate
  • ProjectTemplate
  • WebAppTemplate
  • APIServiceTemplate
  • MobileAppTemplate
• src.modes.enricher package
  • Submodules
• src.modes.enricher.basic_enricher module
  • BasicEnricher
• src.modes.enricher.board_organizer module
  • OrganizationStrategy
  • PhasedStructure
  • ComponentStructure
  • LabelingPlan
  • BoardOrganizer
• src.modes.enricher.enricher_mode module
  • EnricherMode
• src.modes.enricher.task_enricher module
  • EnrichmentPlan
  • BoardContext
  • EnrichedTask
  • TaskEnricher
• src.monitoring package
  • Key Components
  • Monitoring Capabilities
  • Usage Example
  • ProjectMonitor
  • Submodules
• src.monitoring.assignment_monitor module
  • AssignmentMonitor
  • AssignmentHealthChecker
• src.monitoring.error_predictor module
• src.monitoring.project_monitor module
  • Classes
  • Key Features
  • ProjectMonitor
• src.orchestration package
  • Submodules
• src.orchestration.hybrid_tools module
  • HybridMarcusTools
• src.orchestration.mode_registry module
  • ModeSwitch
  • ModeRegistry
• src.visualization package
  • Submodules
• src.visualization.conversation_adapter module
• src.visualization.event_integrated_visualizer module
• src.visualization.shared_pipeline_events module
• src.worker package
  • Classes
  • Inspector
  • create_inspector()
  • Submodules
• src.worker.client module
• src.workflow package
  • Submodules
• src.workflow.project_workflow module

Organization

Modules are organized by package:

• ai/ - AI and intelligence systems

• core/ - Core functionality and models

• intelligence/ - Memory and learning

• integrations/ - External service integrations

• marcus_mcp/ - MCP server implementation

• orchestration/ - Task orchestration

• worker/ - Worker management

• And 20+ more packages…

Use the module index or search to find specific functions/classes.

Module Index

Module Index

Search

Search Page