FAQ - alexar76/aicom GitHub Wiki

FAQ

Detailed FAQ: docs/FAQ.md
Russian / Spanish / French / Chinese: in-repo only โ€” docs/FAQ.ru.md ยท docs/FAQ.es.md ยท docs/FAQ.fr.md ยท docs/FAQ.zh.md ยท see Languages

What is AI-Factory?

Self-hosted multi-agent pipeline: idea โ†’ spec โ†’ code โ†’ QA/E2E โ†’ security โ†’ deploy โ†’ optional storefront.

Storefront vs Admin?

  • Storefront โ€” filtered marketplace-ready products
  • Admin โ†’ Pipeline โ€” all products, all stages (source of truth)

Default password?

None in repo. Bootstrap via TTY or data/secrets/bootstrap_admin.txt. Demo host magic-ai-factory.com: passwordless admin (admin, Enter admin demo).

How long does a run take?

Type Typical
marketing_landing ~20โ€“25 min (DeepSeek, no long repair loops)
full_software ~25โ€“45 min simple brief; hours with gate iterations
First COMPLETED (measured) PulseBoard Mini prod-a25224bcb746: ~91 min wall-clock

LLM cost?

Landing first pass ~$0.30โ€“$2. Tiny full_software can hit first COMPLETED under ~$0.20 (PulseBoard Mini measured $0.181 / ~$0.18); $3โ€“15+ when QA/repair loops pile up. Bring your own keys. See FAQ detail in docs/FAQ.md / root README FAQ.

Why is my product stuck in repair?

Gate failure (demo/TZ, browser crawl, security, methodologist). State: BUG_FOUND โ†’ DEV_FIXING. Check Pipeline tab errors and LLM Logs.

AIFACTORY_GATE_FAILING_MODEL?

Optional model id override on the same LLM provider during repair rounds (quality_repair_round โ‰ฅ 1). Does not switch providers. Example: DeepSeek-only fleet โ†’ set deepseek-reasoner for hard fixes.

AIFACTORY_MAX_QUALITY_LOOPS?

Caps policy audit / remediation cycles before FAILED (default 8).

Discovery not creating products?

Check Director scheduler, AIFACTORY_DISCOVERY_INTERVAL_HOURS, source health at data/discovery/source_health.json, and admin POST /api/admin/discovery/run.

Gallery images missing on GitHub README?

Gallery lives in repo docs/gallery/*.webp. Some mirrors omit binary paths โ€” clone from Gitea or refresh with scripts/capture_gallery_landings.py.

More

Pipeline ยท Security ยท Owner-Guide ยท docs/FAQ.md