Skip to main content

AI Smart Reports 📝

Vartovii provides deeper insights through its AI Smart Report engine. Unlike standard dashboards that just show numbers, AI Smart Reports generate comprehensive, human-readable investment memos (PDFs) analyzing a project's potential and risks.

Overview​

The AI Smart Report system uses Gemini 3.1 Pro preview (with automatic Gemini 2.5 Pro fallback) to synthesize data from multiple sources (Risk Engine, Market Data, Team Intelligence, Security Audits) into a professional 10-page document.

Key Capabilities​

  • Executive Summary: A concise "Buy/Sell/Hold" thesis generated by AI.
  • Risk Analysis: Deep dive into the 6 pillars of the Trust Score.
  • Competitor Comparison: Automatically compares the target project against top rivals in its category.
  • Team Profiling: Detailed background checks on founders and core developers.
  • Visual Data: Includes generated charts for "Trust Score Composition", "Tokenomics", and "Development Activity".

How It Works​

  1. Data Aggregation: The backend ReportDataAggregator collects live data from:
    • Database (Trust Scores, Team Data)
    • BigQuery (Historical trends)
    • External APIs (DefiLlama, Certik, TweetScout)
  2. AI Analysis: The gathered context is sent to Gemini 3.1 Pro preview with a specialized System Prompt designed for financial analysis.
  3. PDF Generation: The AI's structured response is parsed by PDFReportGenerator (using ReportLab), which:
    • Renders Markdown text to formatted PDF.
    • Generates dynamic charts using Matplotlib.
    • Applies Vartovii branding and styling.
  4. Delivery: The user receives a downloadable PDF file.

Report Sections​

  1. Cover Page: Project Logo, Current Trust Score, Date.
  2. Executive Thesis: High-level verdict.
  3. Fundamental Analysis: Financials, Treasury, Tokenomics.
  4. Technical Analysis: Development activity, Code quality, Security.
  5. Social Analysis: Community strength, Sentiment.
  6. Team & Backers: Founder implementation capabilities and Investor quality.
  7. Disclaimer: Standard financial advice disclaimer.

Technical Implementation​

The system is built on a Python backend pipeline:

# Pseudo-code workflow
aggregator = ReportDataAggregator(project_slug)
context_data = await aggregator.collect_all_data()

analyst = AIAnalyst(model="gemini-3.1-pro-preview")
report_content = await analyst.generate_investment_memo(context_data)

pdf_gen = PDFReportGenerator()
pdf_file = pdf_gen.create_pdf(report_content, context_data)
# Returns binary stream to frontend

Usage​

Users can generate reports directly from the Crypto Dashboard:

  1. Select a Project.
  2. Click the "AI Report" button (Sparkles icon) in the header.
  3. Wait for the "Thinking..." process (approx. 15-30 seconds).
  4. Download the generated PDF.