HYBRID ARCHITECTURE

How AISG Works

One small agent on your PC, one decision engine in the cloud. AISG orchestrates 23 open-source security sensors, runs every scan locally on your machine, and returns a professional report — without your code ever leaving your hands.

Start Free Scan See the Steps

At a Glance.

Your first scan, end to end — six steps, most of them one-time setup.

01Get access
02Download worker
03Install & enroll
04Create target
05Run scan
06Get report

One Platform, Two Parts.

AISG is split into two halves on purpose — so that the part that touches your code stays with you.

ON YOUR PC — AISG WORKER

A thin local agent that does all the heavy lifting. You install it once; it stays in your tray.

  • Runs the open-source sensors (SAST, SCA, secrets, infra, DAST, LLM) as isolated Docker containers on your machine
  • Scans local folders and URLs — always from your own IP
  • Reads your code in-place; nothing is uploaded
  • Sends back only findings metadata: tool, rule, title, file:line, severity
  • Polls the cloud for new jobs automatically

This part is a dumb scanner by design — no scoring, no decision logic inside.

IN THE CLOUD — AISG CORE

The decision engine. It never runs a scanner and never sees your code — it turns raw results into decisions.

  • Accounts, quotas, billing and the job queue
  • Receives raw findings, then deduplicates and normalizes them
  • Remaps severities and attributes CWE + ATT&CK techniques
  • Computes the contextual risk score (severity-weighted, deterministic 0–100)
  • Builds the narrative, trend/delta and the professional PDF report

This is the brain — it never ships to your machine, so the analysis stays trustworthy.

YOUR CODE & KEYS STAY WITH YOU — ONLY FINDINGS (METADATA) REACH THE CLOUD

Your First Scan, Step by Step.

Setup happens once. After that, every scan is: create target → click scan → read report.

1

Get access

Create your account (email or Google) and claim the Free Test (7 days · 2 targets · 4 scan runs · Beginner-level sensors). No credit card required for the free slot.

2

Download the worker package

After your access is active, open the Dashboard → Worker tab and click Download worker package. You receive one small file:

aisg-worker-<timestamp>.zip

This is the only file you'll ever need to download from AISG. Extract it to a folder of your choice (e.g. C:\aisg-worker).

3

Install & register the worker

No Python install needed — a portable Python runtime is bundled inside the package. Docker is required (sensors run as isolated containers). Then run the installer once:

# Windows (double-click or run in a terminal):
install.bat

# macOS / Linux:
chmod +x install.sh && ./install.sh

Then go back to Dashboard → Worker → Register Worker. The dashboard shows you two credentials:

worker_id: wkr_xxxxxxxx
secret   : xxxxxxxxxxxxxxxx   ← shown ONCE — save it now

The secret is displayed a single time for security — store it somewhere safe (password manager).

4

Enroll & run the worker

From the folder where you extracted the package, enroll the worker with the credentials above, then keep it running while you scan:

# enroll once (use your own id / secret / AISG URL):
python -m worker enroll --id <worker_id> --secret <secret> --api https://aisg.web.id

# keep this open while scanning (polls for jobs automatically):
python -m worker run

When you see the worker check in as ● ONLINE on your dashboard, you're ready to scan.

5

Create a target & start a scan

In the Dashboard, create a target — either a local folder on your PC (e.g. C:\projects\my-app) or a live URL of your deployed app — then click Scan.

The cloud queues the job and checks your quota (server-side, can't be cheated). Your worker picks it up within seconds and runs the sensor suite locally — live progress (percentage + per-sensor status) streams to your dashboard.

6

Read your report

When the scan finishes, the cloud processes the raw findings (dedup → severity → risk score → narrative) and builds your report: risk score, findings detail with file:line, prioritized remediation plan with fix guidance, checklist coverage and audit evidence. Download it as a professional PDF straight from the dashboard.

Before You Start.

Two free, standard tools — nothing else. No account on a cloud provider, no CI server, no agent cluster.

REQUIREMENTS

🔒 WHAT AISG NEVER SEES

Your source code and your API keys stay on your machine — always. The worker scans in-place and uploads only findings metadata (tool, rule, title, file:line, severity). URL scans also run from your PC, so the AISG cloud IP never contacts your target — and it never gets flagged by your WAF.

Questions.

The ones people actually ask.

What exactly do I download after paying / getting access?

One file: the AISG worker package (aisg-worker-*.zip), available from Dashboard → Worker → Download. It contains the local scan agent — the same part that would otherwise have to be installed manually. That's the only download you'll ever need; everything else happens in the browser.

Is the worker safe to run on my machine?

Yes. It's a thin wrapper that launches the well-known open-source sensors (multi-language SAST, secrets & dependency scanning, …) as isolated Docker containers. It contains no business logic — no scoring, no decision-making — and it's open to your inspection. Every request it sends to the cloud is signed with your per-install secret.

Why not scan directly from the website?

A website cannot reach into your PC — browsers are sandboxed, and a cloud server has no access to your files. More importantly, sending your production code to a third party would defeat the purpose of a security product. Running the scan where your code lives is both the only reliable way and the most private one.

Do I really need Docker?

For now, yes — sensors run as isolated containers so nothing touches your system beyond the worker itself. Docker Desktop is free and a one-time install. (Native binaries are on the roadmap for non-technical users.)

What if my worker is offline when I start a scan?

Your job stays queued in the cloud. The moment your worker comes online, it polls and picks it up automatically. You can also see your worker's status (online/offline) on the Dashboard.

What does AISG actually receive from my scan?

Only the findings: which sensor, which rule, the title, the file and line, and the severity — plus summary counts. Never the file contents, never your keys, never your prompts. The report you receive is built from that metadata.

Ready to see it in action?

Claim the Free Test — 7 days, Beginner-level scan depth, full report. No card required.

Start Free Scan
Early access: AISG is currently in early-access mode. The Free Test is open for the first 25 developers. Scans must be performed only against targets you are authorized to assess — results are indicative and require human review (see Trust & Legal).