Help Centre

Frequently Asked Questions

Start with the basics, then go deeper if needed: what AICVS does, what you get, and how it supports EU AI Act readiness workflows.

The product Why AICVS What you get EU AI Act explained Articles 9–17 Security & privacy Universities Pricing & plans CI/CD & API Roadmap
🔍
What AICVS does
What exactly does AICVS do?

AICVS is an EU AI Act readiness workspace. You record the AI systems your organisation uses, classify their likely risk, work through suggested controls, link evidence (vendor due diligence, policies, human oversight records), and generate readiness reports and audit-pack-style outputs for legal/compliance review — based on the records you provide. Not legal certification.

Optionally, technical teams can run Technical Evidence Scans on uploaded source code or other artefacts. The scan engine uses a 5-layer analysis pipeline (Regex, AST, Statistical Stylometry, Structural, Explainability) to surface compliance signals, map them to relevant EU AI Act articles, and produce a tamper-evident technical evidence report for reviewers. Scans are one feature feeding the readiness workspace — not the whole product.

Each readiness report and scan produces a clear status, findings mapped to EU AI Act articles, a plain-English reviewer summary, and an evidence record for your readiness file.

ℹ️

Important framing: AICVS surfaces compliance signals based on records you provide, not legal certification. A PASS result means no observable compliance markers were found — not that every regulatory rule is met. Use results as part of a broader compliance programme.

What does a compliance score mean?
  • 75–100 → PASS (green): Few or no compliance signals. Suitable for regulated environments without immediate remediation.
  • 50–74 → CONDITIONAL (amber): Some signals detected. Human review required. Address findings before regulatory submission.
  • 0–49 → FAIL (red): Multiple or critical signals. Must be remediated before use in any regulated AI system.

Each finding has a severity (CRITICAL, HIGH, MEDIUM, LOW) and a score impact. CRITICAL findings (e.g. exec() calls, AI authorship comments) subtract the most points. Scores are deterministic — the same file always produces the same result.

⚠️

Scores are not a legal guarantee. Always involve your legal team for final compliance sign-off.

Does AICVS certify EU AI Act compliance?

No. AICVS provides readiness workflows, suggested controls, evidence organisation, technical evidence reports, and audit packs based on available records. It is not legal advice, regulator approval, or legal certification. Outputs should be reviewed by appropriate legal, compliance, or technical experts.

How does the 5-layer detection engine work?
  • Layer 1 — Regex (50+ rules): Pattern matching across all 15 languages. Catches AI API calls, LLM attribution comments, ML imports, auto-generated docstrings, TODO/FIXME placeholders.
  • Layer 2 — Python AST: Structural analysis for Python. Detects exec()/eval(), monolithic classes (>10 methods), dead imports, low cyclomatic complexity.
  • Layer 3 — Statistical Stylometry: Based on arXiv research (2411.04299, 2509.18880). Measures Shannon entropy of line lengths, identifier naming variance, blank-line burstiness, function length uniformity. AI-generated code produces statistically uniform patterns humans don’t.
  • Layer 4 — Structural: Cross-file patterns, evidence chain integrity, documentation coverage.
  • Layer 5 — Explainability: Every finding gets a plain-English explanation and reviewer note for non-technical auditors.

Optional Layer 6: STAT-008 AI-enhanced perplexity scoring (paid plans, opt-in). Sends code to Anthropic API for semantic analysis. A privacy banner warns you before enabling. Off by default.

What programming languages are supported?

15 languages: Python, JavaScript, TypeScript, JSX, TSX, Go, Java, Rust, C#, Ruby, PHP, Swift, Kotlin, C, and C++.

  • Free plan: Python, JavaScript, TypeScript only.
  • Paid plans (e.g. Workspace): All 15 languages.

Python has the deepest analysis (AST + regex + statistical). All others use regex + statistical. Full AST for Go, Java, and TypeScript is on the roadmap for Q3 2026.

What is the 6-step evidence chain and why does it matter?

The Merkle chain creates a tamper-evident audit record. If anything changes — filename, score, timestamp, org ID — the hash changes. Reviewers can verify evidence records independently at aicvs.io/verify/{scan_id}.

  • Step 1: SHA-256 hash of the file content
  • Step 2: Identity hash (filename + scan_id + timestamp + version)
  • Step 3: Provenance hash (step 1 + step 2 + score + classification)
  • Step 4: EU mapping hash (step 3 + articles triggered)
  • Step 5: Merkle root (steps 1–4 combined)
  • Step 6: Evidence chain seal (merkle root + scan_id + version)

This helps organise records that may support legal/compliance review under Art.12 record-keeping — it shows a scan happened, when it happened, and what was found, with cryptographic proof of non-alteration. Whether your full record-keeping programme satisfies Art.12 is for legal/compliance review to confirm. Not legal certification.

🏆
Why teams choose us
How is AICVS different from security scanning tools?

Those tools find security vulnerabilities. AICVS supports a different question: what EU AI Act readiness signals appear in this code, what articles may be relevant for review, and what technical evidence can you record for human-led readiness work? (Not legal certification.)

CapabilitySecurity scannersAICVS
Security bug detection— not the goal
EU AI Act article mapping Art.9–17
Tamper-evident technical evidence reports SHA-256 Merkle
AI authorship signal analysis 5-layer engine
Cross-framework mappings (EU AI Act + ISO/SOC-style signals) from scan outputs Where you run scans
Annex IV-style PDF evidence export Paid plans
University academic integrity dedicated plan

Run AICVS alongside security scanners. They protect your code from bugs. AICVS helps identify EU AI Act readiness gaps and organise evidence for legal/compliance review — it does not remove regulatory risk or guarantee compliance.

Why not use an AI writing detector?

AI writing detectors analyse prose — sentence structure, vocabulary, tone. They cannot analyse source code imports, AST structure, or map findings to regulatory articles.

AICVS is built specifically for source code and is the only tool that:

  • Runs deterministic, reproducible scans (same file = same result, always)
  • Maps code signals directly to EU AI Act articles
  • Generates a cryptographic evidence chain (not a probability estimate)
  • Produces a verifiable, tamper-evident evidence record suitable for audit preparation
🎓

For universities: writing-integrity tools handle essays. AICVS handles code readiness signals. Use the right tool for each workflow.

Why choose AICVS over building our own compliance tooling?

Building your own means: writing and maintaining 50+ regex rules across 15 languages, implementing AST analysis per language, keeping pace with EU AI Act guidance, building a tamper-evident evidence chain, and designing review-ready PDF outputs. AICVS is maintained full-time and updates as new AI tools emerge.

More importantly: your internal tool may not provide independent evidence verification. AICVS evidence records are verifiable at aicvs.io/verify/{scan_id} — third-party proof reviewers can check without trusting your infrastructure.

What is AICVS’s honest limitation?

AICVS cannot detect clean AI-generated code with no observable markers. This is the state of the art across all tools — even the best academic detectors achieve ~82% F1 score (arXiv 2411.04299). If all markers are removed (comments stripped, variables renamed), AICVS will score it high — as will every other tool.

This is why we say “compliance signals”, not “AI detection”. A PASS result means no detectable signals were found — it’s evidence of a clean scan, not proof of human authorship.

⚖️

AICVS outputs are supporting technical evidence, not formal conformity assessments under Art.43. High-risk AI systems may still require notified body assessment for Annex III categories.

📦
Concrete deliverables per scan
What do I actually receive from each scan?

Every scan (including Free plan) produces:

🎯
Compliance Score
0–100 numeric score with PASS / CONDITIONAL / FAIL status. Deterministic — same file always gives same result.
All plans
📋
Findings List
Each finding: rule ID, severity, title, line number, EU article triggered, and remediation steps.
All plans
📖
Reviewer Narrative
Plain-English summary for non-technical reviewers. Professors and compliance officers see what was found and what questions to ask.
All plans
🔐
6-Step Evidence Chain
SHA-256 Merkle chain. Tamper-evident. Publicly verifiable at aicvs.io/verify/{scan_id}.
All plans
📄
Technical Evidence PDF
PDF export with evidence chain, EU article mapping, and Annex IV-style notes for legal/compliance review.
Paid plans
🏅
GitHub SVG Badge
Embeddable badge showing PASS/CONDITIONAL/FAIL with score. Links to your public verification page.
All plans

For Compliance Bundles (paid plans): an aggregated report across EU AI Act + SOC 2 + ISO 27001, with gap analysis and combined technical evidence outputs supporting organisational readiness review.

What goes in a PDF technical evidence report?
  • Organisation name, user name, scan timestamp (UTC)
  • File analysed (name + SHA-256 hash — never the actual content)
  • Compliance score and status
  • Full findings table with severity, rule ID, line number, EU article, and remediation step
  • EU AI Act article mapping summary
  • Plain-English reviewer narrative
  • The full 6-step evidence chain (each step’s hash)
  • Verification URL for independent confirmation
  • Version string and AICVS disclaimer

The PDF supports Art.11 technical documentation preparation, procurement due diligence, and legal/compliance review workflows based on available records.

🇪🇺
What it is, who it affects, and when
What is the EU AI Act?

The EU AI Act (Regulation 2024/1689) is the world’s first comprehensive binding AI law. It entered into force on 1 August 2024 and applies to any company deploying AI systems that affect people in the EU — regardless of where the company is based.

The Act classifies AI into four risk tiers:

  • Unacceptable risk (banned): social scoring, real-time biometric surveillance in public spaces, manipulation of vulnerable groups.
  • High risk (Annex III): AI in critical infrastructure, education, employment, essential services, law enforcement. Heaviest obligations (Art.9–15 + conformity assessment).
  • Limited risk: Chatbots, deepfakes — transparency obligations only.
  • Minimal / no risk: Spam filters, AI in games — no specific obligations.

Deadline: High-risk AI system obligations (Art.9–15) are fully enforced from 2 August 2026. Fines up to €30M or 6% of global annual turnover.

Does the EU AI Act apply to my company?

It applies to you if:

  • You place AI systems on the EU market — including digital services used by EU citizens, regardless of your incorporation country.
  • You deploy AI in Annex III categories: credit scoring, HR screening, fraud detection, medical device software, critical infrastructure, public services.
  • You use AI-generated code or ML models that make decisions affecting EU employees or customers.
💡

Not sure if you’re in scope? Start with the Free plan — the EU article mappings in each scan will show which obligations, if any, are triggered by your code.

What is an Annex IV technical documentation package?

For high-risk AI systems, providers must compile an Annex IV technical documentation package before market placement. It must include:

  • General description of the AI system and intended purpose
  • Description of the development process and elements
  • Information on training, validation, and testing data (Art.10)
  • Risk management documentation (Art.9)
  • System version history and change log
  • Art.14 human oversight measures assessment
  • Art.15 robustness, accuracy, and cybersecurity measures

AICVS PDF evidence reports are designed to be slotted into Annex IV packages as an automated technical evidence layer. They do not replace the full Annex IV package, but reduce manual evidence assembly work.

What is the enforcement timeline?
1 Aug 2024
Act entered into force
24-month transition period begins.
Feb 2025
Prohibited AI systems banned
Social scoring, real-time biometric surveillance prohibited.
Aug 2025
GPAI model obligations apply
General Purpose AI providers (GPT-class) face transparency and copyright obligations.
2 Aug 2026 ← KEY DEADLINE
Full enforcement for high-risk AI systems
Art.9–15 fully enforced. Annex III providers need conformity assessments, technical documentation, and CE marking.
Aug 2027
Annex I product obligations
AI embedded in regulated products (medical devices, machinery, vehicles) faces obligations.
📜
What each article requires — and what AICVS checks
Article-by-article: what each one requires and how AICVS covers it
Art. 9
Risk Management System
Establish a documented, iterative risk management process throughout the AI system’s lifecycle. Identify, analyse, estimate, evaluate, and mitigate risks.
✓ AICVS: Every scan creates a timestamped, cryptographically-chained audit record for your Art.9 risk register. AI-003 flags ML inference calls requiring documented risk controls.
⚠ Fines up to €30M or 6% of global turnover for high-risk AI without compliant risk management.
Art. 10
Data & Training Governance
Training, validation, and testing datasets must meet quality criteria. Free from harmful biases. Relevant, representative, and complete.
✓ AICVS: AI-004 flags ML library imports (numpy, sklearn, torch) indicating training data dependency. AI-002 flags pre-trained model usage requiring data lineage documentation.
⚠ Deploying high-risk AI trained on non-compliant datasets can trigger enforcement and reputational damage.
Art. 11
Technical Documentation
Compile and maintain comprehensive Annex IV technical documentation before placing a high-risk AI system on the market.
✓ AICVS: The 6-step Merkle evidence chain generates Art.11-supporting technical evidence reports with tamper-evident SHA-256 proof. Outputs are formatted for Annex IV-style inclusion.
⚠ Market surveillance can withdraw products from sale if technical documentation is incomplete or absent.
Art. 12
Record-Keeping & Logging
Enable automatic logging of events throughout the operational lifetime of the AI system. Logs must be tamper-resistant.
✓ AICVS: All scans logged with org_id, user_id, timestamp, evidence hash, and EU article mapping. Tamper-evident by cryptographic construction.
⚠ Without verifiable logs, demonstrating operational compliance to regulators is impossible.
Art. 13
Transparency & Information
AI systems must be sufficiently transparent to allow users to interpret outputs and use them appropriately.
✓ AICVS: Generates plain-English narratives per finding. AI-001 flags undisclosed AI authorship comments (GitHub Copilot, ChatGPT annotations).
⚠ Deploying AI without transparency provisions can result in system suspension pending compliance.
Art. 14
Human Oversight
High-risk AI must allow human overseers to monitor, understand, override, and intervene in the system’s operation.
✓ AICVS: AI-003 flags ML inference calls (model.predict()) indicating autonomous decision-making that requires documented human oversight gates.
⚠ Automated decisions without adequate human oversight are a primary enforcement target.
Art. 15
Accuracy, Robustness & Security
High-risk AI must achieve appropriate accuracy and remain resilient to errors, faults, and adversarial attacks throughout the lifecycle.
✓ AICVS: AST-001 flags exec()/eval() calls (CWE-95). AI-006 flags TODO/FIXME/placeholder code signalling incomplete implementation.
⚠ Security vulnerabilities in AI systems trigger both regulatory fines and civil liability for resulting harms.
Art. 17
Quality Management System
Providers of high-risk AI must have a QMS covering design, development, testing, monitoring, and post-market surveillance.
✓ AICVS: Scan history, compliance bundles, and evidence exports integrate into ISO 9001 QMS and ISMS documentation. CI/CD integration enables continuous QMS evidence on every commit.
⚠ A missing QMS is a blocking issue for CE marking and Annex III market access.
Is an AICVS evidence report a formal EU AI Act conformity assessment?

No. AICVS evidence reports are automated technical review outputs — supporting documentation, not a formal conformity assessment. Think of them like an automated penetration test report: it supports your security claim but doesn’t replace a manual pentest.

They are suitable for: Art.11 technical documentation packages, enterprise procurement due diligence, regulatory investigation responses, academic misconduct proceedings. They are not a substitute for a notified body assessment under Art.43 for Annex III high-risk AI systems.

🔒
How we protect your code and data
Do you store my source code?

Never. Your code is read into memory, analysed, and immediately discarded. We store only the scan result: score, findings, and SHA-256 hash. We cannot reconstruct your code from our records — this is an architectural decision, not just a policy.

🛡️

Exception: STAT-008 (Pro+, opt-in). When enabled, code is sent to the Anthropic API for semantic scoring. A warning banner appears before enabling. Off by default.

Is AICVS GDPR compliant?

Yes. We are incorporated in Ireland and process all data within the EU (Frankfurt). We have DPAs with all sub-processors. GDPR rights exercisable via Settings or privacy@aicvs.io.

  • Data residency: Frankfurt, EU only
  • Code never stored: Only hashes and results retained
  • No advertising: Data never shared with advertisers
  • Deletion: Full deletion via Settings → Danger Zone
How are passwords and credentials stored?
  • Passwords: PBKDF2-SHA256, 260,000 iterations, unique random salt per user. Exceeds NIST SP 800-63b. Never stored in plain text.
  • API keys: SHA-256 hashed. Raw key shown only once at creation.
  • JWT tokens: Expire after 8 hours. Refresh tokens rotate on every use. Revoked on logout.
  • 2FA: RFC 6238 TOTP (authenticator app only — no SMS, immune to SIM-swapping).
What attack protections are built in?
  • Rate limiting: 6 independent buckets — max 10 login attempts/min per IP
  • Account lockout: 5 consecutive failures → 15-minute lockout
  • ZIP bomb protection: malicious archives rejected at upload
  • MIME magic-byte validation: files checked against actual content, not extension
  • Path traversal sanitisation: filenames cleaned before processing
  • ReDoS timeout: regex rules run with timeout to prevent denial-of-service
  • Security headers: HSTS (prod), X-Frame-Options: DENY, CSP, X-Content-Type-Options
🎓
Academic use, integrity, and institutional access
How is AICVS different from writing-integrity tools for code?

Writing-integrity tools are designed for written prose. They cannot analyse source code imports, AST structure, or generate cryptographic evidence for disciplinary proceedings.

AICVS is purpose-built for source code submissions: detects AI API attribution comments, structural patterns characteristic of AI-generated code, dead imports, complexity uniformity, and generates tamper-evident evidence for proceedings.

Universities may use writing-integrity tools for essays and AICVS for code. Neither should be the sole basis for misconduct decisions.

Can AICVS evidence be used in academic misconduct proceedings?

Yes. The cryptographic evidence chain is suitable as supporting technical evidence in disciplinary proceedings, similar to how similarity reports may support written-work review.

It proves: which exact file was scanned, when (UTC timestamp), what findings were detected, and that the record has not been altered since the scan.

⚖️

Use alongside academic policy review and institutional investigation procedures. AICVS provides technical evidence; human reviewers make the final determination.

How does the Academic plan work for departments?
  • Monthly credit allowance for technical evidence scan runs — sized for typical module cohorts (see Pricing for current Academic allowance)
  • Bulk ZIP upload: Drop an entire submission folder as one ZIP, get per-file results
  • Technical evidence PDF export per eligible scan run — print-ready records for disciplinary files
  • Team features: Multiple lecturers with role-based access
  • All 15 languages — covers any language taught in your department

For institution-wide use, contact academic@aicvs.io for Enterprise pricing with LMS integration (on roadmap for Canvas, Moodle, Blackboard).

💳
Plans, limits, and billing
What’s the difference between the public pricing paths?
Public pathTypical useBilling
FreeInitial readiness check and evaluation on real examples€0
Audit Window PackFixed-scope one-off review / report windowOne-time (see app)
WorkspaceOngoing readiness records, technical evidence reports, audit-pack style exportsSubscription (see Pricing)
AcademicTeaching and research teamsReduced subscription
ConsultantClient workspaces and portfolio workflowsSubscription or contact-led
EnterpriseLarger or regulated deployments, procurement, custom termsContact sales

Technical evidence scan runs use your plan's included allowance. Details and current limits are shown in the app and on Pricing. Outputs support readiness based on available records; they are not legal certification.

Can I change or cancel at any time?

Yes. Cancel anytime from Settings → Billing. Cancellation takes effect at the end of your current billing period. No cancellation fees, ever. Upgrading takes effect immediately with prorated billing.

Do you offer discounts for startups, non-profits, or research?

Yes. Email hello@aicvs.io. We offer 50% discounts for: early-stage startups (pre-seed/seed), registered non-profits, EU-funded research projects (Horizon, ERC), Enterprise Ireland portfolio companies, and open-source projects with public repositories.

⚙️
GitHub Actions, REST API, and integrations
How do I add AICVS to my GitHub Actions pipeline?

The aicvs/scan-action@v1 GitHub Action is available now. Add it to any workflow:

- uses: aicvs/scan-action@v1
  with:
    api-key: ${{ secrets.AICVS_API_KEY }}
    min-score: 50          # fail if any file scores below this
    fail-on-critical: true # fail immediately on CRITICAL finding
    post-comment: true     # post results as PR review comment
    paths: './src'         # glob to scan (default: changed files)

Get your API key from Settings → API Keys. Set it as a GitHub secret named AICVS_API_KEY.

Use the CI/CD Wizard in the app (sidebar → CI/CD) for a visual YAML generator.

Does AICVS need access to my entire repository?

No. AICVS never requires repository access. You push files to the API — it never pulls from your repo. The GitHub Action only accesses files you specify in paths (default: changed files in the current PR). Your full codebase is never transmitted.

Can I use the REST API directly?

Yes. Full API documentation at https://api.aicvs.io/docs. Key endpoints:

  • POST /api/v1/scans — single file scan
  • POST /api/v1/scans/bulk — ZIP upload (paid plans)
  • GET /api/v1/scans/{id}/certificate.pdf — Technical Evidence Report PDF download (paid plans)
  • GET /api/v1/badge/{scan_id}.svg — SVG badge (public)
  • GET /api/v1/scans/{id}/verify — public verification (no auth)

Authenticate with Authorization: Bearer <jwt> or X-Api-Key: <api-key>.

07
Product roadmap

We are actively expanding AICVS in three areas:

  • Enterprise controls — persistent revocation, advanced audit retention, and organisation-level policy controls.
  • Workflow controls — rule suppression management, dashboard review flows, and Stripe billing automation.
  • Detection depth — broader AST support for Go, Java, and TypeScript, database-managed rules, and LMS integrations (Canvas, Moodle, Blackboard).

Some advanced modules, including AI watermarking and federated-learning audit, are experimental and not part of the core technical evidence reporting workflow unless explicitly enabled. Core scan reports, article mappings, evidence chains, and verification pages are live today. Roadmap items are not included in compliance outputs until released.

Still have questions?

Our team responds within a few hours during business hours (Limerick, GMT/IST).