Skip to content

Official Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.

the cloud notice: a README block, and a short notice at crawl4ai-setup and once per machine at first run

unclecodeb7ea0000172d
diff --git a/README.md b/README.md
index 310ac024..96beb035 100644
--- a/README.md
+++ b/README.md
@@ -13,12 +13,11 @@
[![GitHub Sponsors](https://img.shields.io/github/sponsors/unclecode?style=flat&logo=GitHub-Sponsors&label=Sponsors&color=pink)](https://github.com/sponsors/unclecode)
---
-#### 🚀 Crawl4AI Cloud API — Closed Beta (Launching Soon)
-Reliable, large-scale web extraction, now built to be _**drastically more cost-effective**_ than any of the existing solutions.
+#### ☁️ Crawl4AI Cloud is live — the same crawler, hosted
+No browsers to run, no proxies to buy, no cookies to babysit. One key with **$5 of free credit**, and your AI agent can search, scrape, crawl and extract the web through the engine you already use. Works in Claude Code, Codex, OpenCode and Cursor with one pasted line.
-👉 **Apply [here](https://forms.gle/E9MyPaNXACnAMaqG7) for early access**
-_We’ll be onboarding in phases and working closely with early users.
-Limited slots._
+👉 **[Get a key in 10 seconds](https://crawl4ai.com/?ref=readme)** · [Cloud docs](https://crawl4ai.com/docs?ref=readme)
+_The library stays open source, forever. The cloud is for the days you want to build fast and let us run the infrastructure._
---
diff --git a/crawl4ai/async_webcrawler.py b/crawl4ai/async_webcrawler.py
index a2aabcc4..a9ba6660 100644
--- a/crawl4ai/async_webcrawler.py
+++ b/crawl4ai/async_webcrawler.py
@@ -182,6 +182,12 @@ class AsyncWebCrawler:
"""
await self.crawler_strategy.__aenter__()
self.logger.info(f"Crawl4AI {crawl4ai_version}", tag="INIT")
+ try:
+ from .cloud_notice import show_once
+
+ show_once(self.logger)
+ except Exception:
+ pass
self.ready = True
return self
diff --git a/crawl4ai/cli.py b/crawl4ai/cli.py
index 02b67155..6ac26178 100644
--- a/crawl4ai/cli.py
+++ b/crawl4ai/cli.py
@@ -1648,6 +1648,12 @@ def main():
import sys
if len(sys.argv) < 2 or sys.argv[1] not in cli.commands:
sys.argv.insert(1, "crawl")
+ try:
+ from .cloud_notice import show_once
+
+ show_once()
+ except Exception:
+ pass
cli()
if __name__ == "__main__":
diff --git a/crawl4ai/cloud_notice.py b/crawl4ai/cloud_notice.py
new file mode 100644
index 00000000..4111cae7
--- /dev/null
+++ b/crawl4ai/cloud_notice.py
@@ -0,0 +1,73 @@
+"""The Crawl4AI Cloud notice: one short block that tells a user the hosted version exists.
+
+It prints in two places: at the end of ``crawl4ai-setup`` (every time), and once per machine when the
+first ``AsyncWebCrawler`` starts or the ``crwl`` CLI first runs (a marker file in the crawl4ai home
+folder remembers it). ``CRAWL4AI_NO_CLOUD_NOTICE=1`` turns it off everywhere, for operators who run the
+library in production logs.
+"""
+
+import os
+from pathlib import Path
+
+CLOUD_URL = "https://crawl4ai.com/?ref=pip"
+_ENV_OFF = "CRAWL4AI_NO_CLOUD_NOTICE"
+_MARKER = ".cloud-notice-shown"
+
+LINES = (
+ "Crawl4AI Cloud is live: the same crawler, hosted. No browsers to run, no proxies, $5 of free credit.",
+ f"Get a key in 10 seconds: {CLOUD_URL} (the library stays open source, forever)",
+ f"Hide this notice: {_ENV_OFF}=1",
+)
+
+
+def _home() -> Path:
+ try:
+ from .utils import get_home_folder
+
+ return Path(get_home_folder())
+ except Exception:
+ return Path.home() / ".crawl4ai"
+
+
+def is_off() -> bool:
+ """True when the operator turned the notice off with the environment variable."""
+ return os.environ.get(_ENV_OFF, "").strip().lower() in ("1", "true", "yes")
+
+
+def text() -> str:
+ """The notice as one block of text."""
+ return "\n".join(LINES)
+
+
+def show_at_install(logger=None) -> None:
+ """Print the notice at the end of ``crawl4ai-setup``. Every run; nothing is remembered."""
+ if is_off():
+ return
+ if logger is not None:
+ for line in LINES:
+ logger.info(line, tag="CLOUD")
+ else:
+ print(text())
+
+
+def show_once(logger=None) -> bool:
+ """Print the notice the first time the library or the CLI runs on this machine. Returns True when
+ it printed. The marker file keeps it to one time; a machine without a writable home never repeats
+ the notice more than once per process."""
+ if is_off():
+ return False
+ marker = _home() / _MARKER
+ try:
+ if marker.exists():
+ return False
+ marker.parent.mkdir(parents=True, exist_ok=True)
+ marker.write_text("shown\n")
+ except Exception:
+ # no writable home: show it this once, and again next process (rare, acceptable)
+ pass
+ if logger is not None:
+ for line in LINES:
+ logger.info(line, tag="CLOUD")
+ else:
+ print(text())
+ return True
diff --git a/crawl4ai/install.py b/crawl4ai/install.py
index 68726ed8..5c4e69bf 100644
--- a/crawl4ai/install.py
+++ b/crawl4ai/install.py
@@ -63,7 +63,13 @@ def post_install():
# TODO: Will be added in the future
# setup_builtin_browser()
logger.success("Post-installation setup completed!", tag="COMPLETE")
-
+ try:
+ from .cloud_notice import show_at_install
+
+ show_at_install(logger)
+ except Exception:
+ pass
+
def setup_builtin_browser():
"""Set up a builtin browser for use with Crawl4AI"""
try: