How lintsinghua/deepaudit works
DeepAudit is a web-based AI security-auditing product. The documented user journey is to manage or import a project, launch an Agent audit, follow its live execution, inspect findings, and export a report; the product also supports instant code analysis, rules, prompts, and project dashboards. The graph combines those documented capabilities with source-index relationships and excerpts. Several central implementations were not sampled, so uncertain runtime links are omitted or marked unverified.
Main entry points: agent_tasks.py Agent task API · routes.tsx Product routes · index.tsx Agent audit UI · orchestrator.py Agent orchestration
Components 24
Web application
- Product routes
frontend/src/app/routes.tsx - Agent audit UI
frontend/src/pages/AgentAudit/index.tsx - Stream hook
frontend/src/hooks/useAgentStream.ts - Project management
frontend/src/pages/Projects.tsx - Instant analysis
frontend/src/pages/InstantAnalysis.tsx - Report export
frontend/src/features/reports/services/reportExport.ts
API and projects
- API router
backend/app/api/v1/api.py - Agent task API
backend/app/api/v1/endpoints/agent_tasks.py - Project API
backend/app/api/v1/endpoints/projects.py - Repository scanner
backend/app/services/scanner.py - Audit task records
backend/app/models/agent_task.py
Audit engine
- Agent orchestration
backend/app/services/agent/agents/orchestrator.py - Agent runtime
backend/app/services/agent/agents/base.py - Audit events
backend/app/services/agent/event_manager.py - Event streaming
backend/app/services/agent/streaming/stream_handler.py
Analysis intelligence
- LLM service
backend/app/services/llm/service.py - Provider factory
backend/app/services/llm/factory.py - LiteLLM adapter
backend/app/services/llm/adapters/litellm_adapter.py - Framework knowledge
backend/app/services/agent/knowledge/frameworks/fastapi.py - RAG retrieval
backend/app/services/rag/retriever.py
Platform services
- Application database
backend/app/db/session.py - Runtime configuration
backend/app/core/config.py - Project ZIP storage
backend/app/services/zip_storage.py
Other components
- Auditor
Connections 24
- Auditor → Product routes: uses
README.md - Product routes → Agent audit UI: routes to
frontend/src/app/routes.tsx - Product routes → Project management: routes to
frontend/src/app/routes.tsx - Product routes → Instant analysis: routes to
frontend/src/app/routes.tsx - Agent audit UI → Stream hook: uses stream
- Agent audit UI → Agent task API: starts audit
- Project management → Project API: manages projects
- Instant analysis → Repository scanner: submits analysis
- Report export → Agent audit UI: exports report
- API router → Agent task API: registers
backend/app/api/v1/api.py - API router → Project API: registers
backend/app/api/v1/api.py - Agent task API → Audit task records: reads and writes
backend/app/api/v1/endpoints/agent_tasks.py - Agent task API → Agent orchestration: launches audit
- Agent orchestration → Agent runtime: uses runtime
backend/app/services/agent/agents/orchestrator.py - Agent orchestration → LLM service: requests analysis
- Agent task API → Audit events: streams task events
backend/app/api/v1/endpoints/agent_tasks.py - Audit events → Audit task records: persists events
backend/app/services/agent/event_manager.py - Stream hook → Event streaming: receives events
- LLM service → Provider factory: creates adapter
backend/app/services/llm/service.py - Provider factory → LiteLLM adapter: selects provider
- Agent runtime → Framework knowledge: uses guidance
- Agent runtime → RAG retrieval: retrieves context
- Runtime configuration → Application database: configures connection
backend/app/db/session.py - Runtime configuration → Project ZIP storage: sets storage path
backend/app/services/zip_storage.py