import json, re, zipfile from pathlib import Path from datetime import date ROOT = Path(__file__).parent PUBLIC = ROOT / "public" OUT = ROOT.parents[1] / "outputs" / "aimars-premium-hub-v4.zip" SITE = "https://aimars.online" TODAY = date.today().isoformat() PROVIDERS = ["OpenAI","Anthropic","Google","Meta","Mistral","DeepSeek","Hugging Face","Stability AI","Runway","ElevenLabs"] PROVIDER_MAP = { "chatgpt": "OpenAI", "dalle": "OpenAI", "claude": "Anthropic", "gemini": "Google", "notebooklm": "Google", "midjourney": "Midjourney", "adobe-firefly": "Adobe", "canva-ai": "Canva", "runway": "Runway", "pika": "Pika", "cursor": "Cursor", "github-copilot": "GitHub", "windsurf": "Windsurf", "elevenlabs": "ElevenLabs", "perplexity": "Perplexity", "zapier-ai": "Zapier" } NAV = """""" NAV_SUB = NAV.replace('href="index.html"', 'href="../index.html"') for name in ["models","tools","providers","rankings","compare","categories","pricing","developers","ai-tool-finder","submit-tool","best-free-ai-tools","ai-image-generator","blog","unlock-free-ai-tools"]: NAV_SUB = NAV_SUB.replace(f'href="{name}.html"', f'href="../{name}.html"') def esc(s): return str(s).replace("&","&").replace("<","<").replace(">",">").replace('"',""") def slug(s): return re.sub(r"[^a-z0-9]+", "-", str(s).lower()).strip("-") def schema(obj): return '" def write(rel, text): p = PUBLIC / rel p.parent.mkdir(parents=True, exist_ok=True) p.write_text(text, encoding="utf-8") def read_tools(): return json.loads((PUBLIC / "tools.json").read_text(encoding="utf-8")) def save_tools(tools): (PUBLIC / "tools.json").write_text(json.dumps(tools, indent=2, ensure_ascii=False), encoding="utf-8") def infer_type(t): c = (t.get("category","") + " " + t.get("best_for","")).lower() if any(x in c for x in ["model","research","writing","students"]): return "model" if "image" in c: return "image_generator" if "video" in c: return "video_tool" if "coding" in c or "code" in c: return "coding_assistant" if "business" in c or "automation" in c: return "business_tool" return "ai_tool" def pricing_type(t): text = (t.get("pricing","") + " " + t.get("free_plan","")).lower() if "free" in text and ("paid" in text or "$" in text or "plus" in text or "pro" in text): return "freemium" if "free" in text: return "free" if "paid" in text or "$" in text: return "paid" return "unknown" def upgrade_tools(): tools = read_tools() for i, t in enumerate(tools, 1): p = PROVIDER_MAP.get(t.get("slug"), t.get("provider") or t.get("name","").split()[0]) t.setdefault("id", i) t.setdefault("type", infer_type(t)) t.setdefault("provider", p) t.setdefault("website_url", t.get("official_url") or t.get("affiliate_url") or "") t.setdefault("logo", f"assets/logos/{slug(p)}.svg") t.setdefault("pricing_type", pricing_type(t)) t.setdefault("input_price", None) t.setdefault("output_price", None) t.setdefault("context_length", "Unknown") base = int(float(t.get("rating", 0)) * 20) if t.get("trending"): base += 5 if t.get("featured"): base += 4 t.setdefault("popularity_score", min(100, base)) t.setdefault("ranking_score", min(100, base + (3 if t.get("free_plan","").lower().startswith("yes") else 0))) tags = set(t.get("tags") or []) for part in re.split(r"[,/ ]+", t.get("category","")): if part and len(part) > 2: tags.add(part.lower()) tags.add(t["type"]) tags.add(t["provider"].lower().replace(" ", "-")) t["tags"] = sorted(tags) for key in ("cpa_url","affiliate_url","manual_cpa_url","manual_affiliate_url","pending_review","featured","trending"): t.setdefault(key, "" if "url" in key else False) save_tools(tools) return tools def head(path, title, desc, extra=()): url = SITE + "/" + path return f"""{esc(title)}{''.join(schema(x) for x in extra)}""" def footer(): return """Free AI Tools

""" def page(path, title, desc, body, extra=()): return f'{head(path,title,desc,extra)}{NAV}{body}{footer()}' def card(t): price = t.get("pricing_type","unknown") return f"""

{esc(t['name'][:2].upper())}

{esc(t['name'])}

{esc(t.get('provider','Unknown'))}

#{int(t.get('ranking_score',0))}

{esc(t.get('short_description',''))}

{esc(t.get('type','ai_tool'))}{esc(price)}{esc(t.get('context_length','Unknown'))}

Details Visit

""" def table(items): rows = "".join(f"""#{i}{esc(t['name'])}{esc(t.get('provider',''))} / {esc(t.get('type',''))}{esc(t.get('pricing_type',''))}{esc(t.get('context_length','Unknown'))}{esc(t.get('popularity_score',''))}{esc(t.get('ranking_score',''))}Open""" for i,t in enumerate(items,1)) return f"""

{rows}

Rank	Name	Pricing	Context	Popularity	Score

""" def add_css(): css = PUBLIC / "css/style.css" extra = """ .finder-quiz{display:grid;gap:14px}.quiz-options{display:flex;gap:8px;flex-wrap:wrap}.quiz-options label{border:1px solid rgba(148,163,184,.16);background:rgba(255,255,255,.05);border-radius:8px;padding:10px 12px;cursor:pointer}.submit-card textarea{min-height:120px}.provider-logo{width:42px;height:42px;border-radius:8px;display:grid;place-items:center;background:linear-gradient(135deg,rgba(103,232,249,.18),rgba(192,132,252,.18));border:1px solid rgba(148,163,184,.18);font-weight:950}.pricing-matrix{display:grid;grid-template-columns:repeat(4,1fr);gap:14px}.developer-code{font-family:ui-monospace,Menlo,Consolas,monospace;background:rgba(2,6,23,.75);border:1px solid rgba(148,163,184,.16);border-radius:8px;padding:16px;overflow:auto}.security-note{border-color:rgba(251,191,36,.3);background:rgba(251,191,36,.08)}@media(max-width:900px){.pricing-matrix{grid-template-columns:1fr 1fr}.nav-premium .links{max-height:calc(100vh - 84px);overflow:auto}}@media(max-width:560px){.pricing-matrix{grid-template-columns:1fr}.quiz-options{display:grid}.nav-premium .links a{font-size:13px}} """ s = css.read_text(encoding="utf-8") if ".finder-quiz" not in s: css.write_text(s + "\n" + extra, encoding="utf-8") def update_nav_all(): for f in PUBLIC.rglob("*.html"): if f.name == "admin.html": continue s = f.read_text(encoding="utf-8") nav = NAV_SUB if f.parent.name == "tools" else NAV s = re.sub(r'

AIMars data hub

{h1}

Search by provider, type, pricing, context length, popularity and ranking score.

{len(items)} entries

Use tool finder

{table(items[:20])}

{''.join(card(t) for t in items[:12])}

""" write(file, page(file, title, desc, body, [{"@context":"https://schema.org","@type":"ItemList","name":h1,"itemListElement":[{"@type":"ListItem","position":i+1,"name":t["name"],"url":SITE+"/tools/"+t["slug"]+".html"} for i,t in enumerate(items[:20])]}])) by_cat = {} for t in tools: by_cat.setdefault(t["category"], []).append(t) cat_body = f"""

Explore AI categories

Browse by workflow, provider, pricing type and model/tool category.

{''.join(f'{len(v)} tools

{esc(k)}

Top provider: {esc(v[0].get("provider","Unknown"))}. Pricing types: {esc(", ".join(sorted(set(x.get("pricing_type","unknown") for x in v))))}

' for k,v in by_cat.items())}

""" write("categories.html", page("categories.html", "AI Tool Categories | AIMars", "Browse AI tool categories using upgraded provider, type and pricing data.", cat_body)) def provider_pages(tools): by_provider = {p: [] for p in PROVIDERS} for t in tools: p = t.get("provider","") if p in by_provider: by_provider[p].append(t) cards = [] for p in PROVIDERS: items = by_provider[p] score = round(sum(x.get("ranking_score",0) for x in items)/len(items), 1) if items else "New" cards.append(f"""

{esc(p[:2].upper())}

{esc(p)}

{len(items)} indexed entries

{score}

Provider page logic is ready for dedicated provider pages as the database grows. Current entries are listed below when available.

{''.join(f'{esc(x["name"])}' for x in items[:3])}

""") body = f"""

Providers

AI providers

Explore tools and models by provider across OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, Hugging Face, Stability AI, Runway and ElevenLabs.

{''.join(cards)}

""" write("providers.html", page("providers.html", "AI Providers | AIMars", "Browse AI providers and their indexed tools, models, pricing and ranking data.", body)) def utility_pages(tools): pricing_body = f"""

Pricing

AI pricing index

Compare free, freemium, paid and unknown pricing models before choosing your AI stack.

{''.join(f'

{kind}

{sum(1 for t in tools if t.get("pricing_type")==kind)}

Indexed {kind} entries.

' for kind in ["free","freemium","paid","unknown"])}

{table(tools[:16])}

""" write("pricing.html", page("pricing.html", "AI Tool Pricing | AIMars", "Compare AI tool pricing types, free plans, model prices and ranking scores.", pricing_body)) dev_body = """

Developers

AIMars developer data

Use the JSON directory and updater scripts to build provider pages, category pages and comparison surfaces.

Public data files

tools.json includes provider, type, pricing, context, tags and ranking scores. The update script imports public metadata as pending review.

GET /tools.json\npython scripts/update_tools.py

Launch security

Change ADMIN_TOKEN in config.php before going live. Keep storage protected and review pending tools before featuring them.

""" write("developers.html", page("developers.html", "Developers | AIMars", "Developer notes for AIMars tools.json, public metadata updater scripts and API placeholders.", dev_body)) def finder_page(tools): body = f"""

AI tool finder

Find your best AI tool

Answer four quick questions and get recommended tools from the AIMars dataset.

Recommended tools

Your matches will appear here.

Unlock full free AI list

""" write("ai-tool-finder.html", page("ai-tool-finder.html", "AI Tool Finder | AIMars", "Answer a short quiz to find recommended AI tools and models from the AIMars dataset.", body)) def submit_page(): body = """

Submit

Submit an AI tool

Suggest a tool for editorial review. Submissions are stored for review and do not become featured automatically.

""" write("submit-tool.html", page("submit-tool.html", "Submit an AI Tool | AIMars", "Submit an AI tool to AIMars for editorial review.", body)) def update_home_links(): p = PUBLIC / "index.html" s = p.read_text(encoding="utf-8") if "Complete the hub" not in s: block = """

Explore

Complete the hub

Provider research, pricing scans, developer data and a guided finder are now part of AIMars.

Providers

Browse AI providers and indexed tools.

Pricing

Compare free, freemium and paid tools.

Developers

Use tools.json and updater scripts.

AI Tool Finder

Answer a quiz and get recommendations.

Submit Tool

Suggest a tool for review.

""" s = s.replace('

', block + '

', 1) p.write_text(s, encoding="utf-8") def update_app_js(): p = PUBLIC / "js/app.js" s = p.read_text(encoding="utf-8") if "data-submit-tool-form" not in s: s += r""" document.addEventListener('submit',async e=>{if(!e.target.matches('[data-submit-tool-form]'))return;e.preventDefault();const form=e.target;const payload={type:'submission',date:new Date().toISOString(),page_url:location.href,user_agent:navigator.userAgent};for(const [k,v] of new FormData(form).entries())payload[k]=v;try{await fetch('submissions.php',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(payload)})}catch(err){const rows=JSON.parse(localStorage.getItem('aimars_submissions_fallback')||'[]');rows.push(payload);localStorage.setItem('aimars_submissions_fallback',JSON.stringify(rows))}track('tool_submission_submit',{source_cta:'submit-tool'});form.innerHTML='

Submission received

Thanks. Your tool is queued for manual review.

'}); const finder=document.querySelector('#finderQuiz');if(finder){finder.addEventListener('submit',e=>{e.preventDefault();const data=JSON.parse(document.querySelector('#finderData').textContent);const fd=new FormData(finder);const need=fd.get('need'),free=fd.get('free'),level=fd.get('level');let picks=data.filter(t=>{const hay=(t.type+' '+t.category+' '+(t.tags||[]).join(' ')+' '+t.best_for).toLowerCase();let ok=hay.includes(need)||need==='writing'&&/model|research|writing/.test(hay)||need==='business'&&/business|automation/.test(hay);if(free==='yes')ok=ok&&(String(t.free_plan).toLowerCase().includes('yes')||t.pricing_type==='free'||t.pricing_type==='freemium');if(level==='beginner')ok=ok&&!/api|developer/.test(hay);return ok}).sort((a,b)=>(b.ranking_score||0)-(a.ranking_score||0)).slice(0,4);if(!picks.length)picks=data.slice(0,4);document.querySelector('#finderResults').innerHTML=picks.map(t=>`

${t.name}

${t.short_description}

Open details

`).join('');track('ai_tool_finder_submit',{need,free,level})})} """ p.write_text(s, encoding="utf-8") def storage_security(): storage = PUBLIC / "storage" storage.mkdir(exist_ok=True) for name in ["leads.json","events.json","submissions.json"]: old = PUBLIC / name new = storage / name if old.exists(): new.write_text(old.read_text(encoding="utf-8"), encoding="utf-8") elif not new.exists(): new.write_text("[]\n", encoding="utf-8") write("storage/.htaccess", "Require all denied\nDeny from all\n") write(".htaccess", """Options -Indexes Require all denied Deny from all Require all denied Deny from all RedirectMatch 403 ^/scripts(/|$) """) leads = PUBLIC / "leads.php" if leads.exists(): s = leads.read_text(encoding="utf-8") s = s.replace("__DIR__ . ($type === 'lead' ? '/leads.json' : '/events.json')", "__DIR__ . ($type === 'lead' ? '/storage/leads.json' : '/storage/events.json')") leads.write_text(s, encoding="utf-8") write("submissions.php", """false,'error'=>'Invalid JSON']); exit; } $email = filter_var($data['contact_email'] ?? '', FILTER_VALIDATE_EMAIL); $url = filter_var($data['website_url'] ?? '', FILTER_VALIDATE_URL); if (!$email || !$url || empty($data['tool_name'])) { http_response_code(422); echo json_encode(['ok'=>false,'error'=>'Missing required fields']); exit; } $file = __DIR__ . '/storage/submissions.json'; $rows = file_exists($file) ? json_decode(file_get_contents($file), true) : []; if (!is_array($rows)) $rows = []; $rows[] = [ 'tool_name' => strip_tags($data['tool_name']), 'website_url' => $url, 'category' => strip_tags($data['category'] ?? ''), 'description' => strip_tags($data['description'] ?? ''), 'pricing' => strip_tags($data['pricing'] ?? ''), 'free_plan' => strip_tags($data['free_plan'] ?? ''), 'contact_email' => $email, 'date' => $data['date'] ?? gmdate('c'), 'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? '' ]; file_put_contents($file, json_encode($rows, JSON_PRETTY_PRINT|JSON_UNESCAPED_SLASHES)); echo json_encode(['ok'=>true]); ?>""") admin = PUBLIC / "admin.html" if admin.exists(): s = admin.read_text(encoding="utf-8") if "Change ADMIN_TOKEN" not in s: s = s.replace("

Manage AI tools

", '

Manage AI tools

Security warning: Change ADMIN_TOKEN in config.php before going live.

', 1) if 'noindex,nofollow' not in s: s = s.replace("AIMars Admin", 'AIMars Admin') admin.write_text(s, encoding="utf-8") def sitemap(): sm = PUBLIC / "sitemap.xml" s = sm.read_text(encoding="utf-8") for file in ["providers.html","pricing.html","developers.html","submit-tool.html","ai-tool-finder.html"]: loc = SITE + "/" + file if loc not in s: s = s.replace("", f'{loc}{TODAY}weekly0.8\n') sm.write_text(s, encoding="utf-8") def package(): if OUT.exists(): OUT.unlink() with zipfile.ZipFile(OUT, "w", zipfile.ZIP_DEFLATED) as z: for base in ("public","scripts"): root = ROOT / base if root.exists(): for f in root.rglob("*"): if f.is_file(): z.write(f, f.relative_to(ROOT)) for name in ("SETUP_GUIDE.md","build_upgrade.py","phase2_upgrade.py","phase3_premium_hub.py","phase4_finish_hub.py"): f = ROOT / name if f.exists(): z.write(f, f.relative_to(ROOT)) def main(): tools = upgrade_tools() add_css() update_nav_all() rewrite_core_pages(tools) provider_pages(tools) utility_pages(tools) finder_page(tools) submit_page() update_home_links() update_app_js() storage_security() sitemap() package() print(OUT) if __name__ == "__main__": main()

Unlock the curated free AI tools list

{esc(t['name'])}