crawl4ai

(โ˜… 78,856)

๐Ÿš€๐Ÿค– Crawl4AI: ์˜คํ”ˆ์†Œ์Šค LLM ์นœํ™”์  ์›น ํฌ๋กค๋Ÿฌ & ์Šคํฌ๋ ˆ์ดํผ. ๋ง์„ค์ด์ง€ ๋ง๊ณ  ์ฐธ์—ฌํ•˜์„ธ์š”: https://discord.gg/jP8KfhDhyN

  • .env.txt
  • .gitattributes
  • .gitignore
  • CHANGELOG.md
  • cliff.toml
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • CONTRIBUTORS.md
  • docker-compose.yml
  • Dockerfile
  • JOURNAL.md
  • LICENSE
  • MANIFEST.in
  • MISSION.md
  • mkdocs.yml
  • PROGRESSIVE_CRAWLING.md
  • pyproject.toml
  • README-first.md
  • README.md
  • requirements.txt
  • ROADMAP.md
  • SECURITY-CREDITS.md
  • SECURITY.md
  • setup.cfg
  • setup.py
  • SPONSORS.md
  • test_llm_webhook_feature.py
  • test_webhook_implementation.py
  • uv.lock

# ์„ค์น˜ ๊ฐ€์ด๋“œ

1. ์ฝ”๋“œ ๋‚ด๋ ค๋ฐ›๊ธฐ
git clone https://github.com/unclecode/crawl4ai

๊นƒํ—ˆ๋ธŒ์—์„œ ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ ์ „์ฒด๋ฅผ ๋‚ด ์ปดํ“จํ„ฐ๋กœ ๋‚ด๋ ค๋ฐ›์Šต๋‹ˆ๋‹ค.

cd crawl4ai

๋ฐฉ๊ธˆ ๋‚ด๋ ค๋ฐ›์€ ํ”„๋กœ์ ํŠธ ํด๋” ์•ˆ์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.

2. ๊ณต์‹ ์„ค์น˜ ์Šคํฌ๋ฆฝํŠธ

์‰ฌ์›€ ์ถ”์ฒœ
์‚ฌ์ „ ์ค€๋น„๋ฌผ
  • Python 3 pip ๋ช…๋ น์–ด๋ฅผ ์“ฐ๋ ค๋ฉด Python์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
pip install -U crawl4ai

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

pip install crawl4ai --pre

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

pip install crawl4ai

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

pip install crawl4ai[sync]

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

โœ… ์„ค์น˜ ํ›„ ์ƒˆ ํ„ฐ๋ฏธ๋„์„ ์—ด๊ณ , ํ”„๋กœ๊ทธ๋žจ์˜ ๋ฒ„์ „ ํ™•์ธ ๋ช…๋ น(์˜ˆ: --version)์œผ๋กœ ์ •์ƒ ์„ค์น˜๋๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”.

์ด ๋ ˆํฌ์˜ README์— ์ ํžŒ ์‹ค์ œ ๋ช…๋ น์–ด๋ฅผ ๊ทธ๋Œ€๋กœ ๊ฐ€์ ธ์™”์Šต๋‹ˆ๋‹ค.

3. Docker

์‰ฌ์›€
์‚ฌ์ „ ์ค€๋น„๋ฌผ
  • Git GitHub์—์„œ ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ๋ฅผ ๋‚ด๋ ค๋ฐ›์œผ๋ ค๋ฉด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
  • Docker Desktop ์ปจํ…Œ์ด๋„ˆ๋ฅผ ๋นŒ๋“œํ•˜๊ณ  ์‹คํ–‰ํ•˜๋ ค๋ฉด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ์„ค์น˜ ํ›„ ์‹คํ–‰ํ•ด์„œ ๋ฐฑ๊ทธ๋ผ์šด๋“œ์— ์ผœ๋‘์„ธ์š”.
docker pull unclecode/crawl4ai:latest

์ด ๋ช…๋ น์–ด๋ฅผ ํ„ฐ๋ฏธ๋„์— ๊ทธ๋Œ€๋กœ ์ž…๋ ฅํ•ด ์‹คํ–‰ํ•˜์„ธ์š”.

docker run -d -p 11235:11235 --name crawl4ai --shm-size=1g unclecode/crawl4ai:latest

๋นŒ๋“œ๋œ ์ด๋ฏธ์ง€๋ฅผ ์‹ค์ œ ์ปจํ…Œ์ด๋„ˆ๋กœ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

โœ… ํ„ฐ๋ฏธ๋„์— docker compose ps ๋ฅผ ์ž…๋ ฅํ•ด ์ปจํ…Œ์ด๋„ˆ๋“ค์ด Up ์ƒํƒœ์ธ์ง€ ํ™•์ธํ•˜์„ธ์š”. README์— ํฌํŠธ ๋ฒˆํ˜ธ๊ฐ€ ์ ํ˜€์žˆ๋‹ค๋ฉด ๋ธŒ๋ผ์šฐ์ €์—์„œ http://localhost:ํฌํŠธ๋ฒˆํ˜ธ ๋กœ ์ ‘์†ํ•ด๋ณด์„ธ์š”.

์ด ๋ ˆํฌ์˜ README์— ์ ํžŒ ์‹ค์ œ ๋ช…๋ น์–ด๋ฅผ ๊ทธ๋Œ€๋กœ ๊ฐ€์ ธ์™”์Šต๋‹ˆ๋‹ค.

4. Python

์‰ฌ์›€
์‚ฌ์ „ ์ค€๋น„๋ฌผ
  • Git GitHub์—์„œ ํ”„๋กœ์ ํŠธ ์ฝ”๋“œ๋ฅผ ๋‚ด๋ ค๋ฐ›์œผ๋ ค๋ฉด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
  • Python 3 ์„ค์น˜ ์‹œ 'Add Python to PATH' ์˜ต์…˜์„ ๊ผญ ์ฒดํฌํ•˜์„ธ์š” (Windows).
pip install -U crawl4ai

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

pip install crawl4ai --pre

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

python -m playwright install --with-deps chromium

ํŒŒ์ด์ฌ ์Šคํฌ๋ฆฝํŠธ(๋˜๋Š” ๋ชจ๋“ˆ)๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

pip install crawl4ai

PyPI์— ๋ฐฐํฌ๋œ ํŒจํ‚ค์ง€๋ฅผ ๋ฐ”๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. ์†Œ์Šค ํด๋ก ์ด ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค.

python -m playwright install chromium

ํŒŒ์ด์ฌ ์Šคํฌ๋ฆฝํŠธ(๋˜๋Š” ๋ชจ๋“ˆ)๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

โœ… ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ ์—†์ด ์‹คํ–‰๋˜๊ณ  ํ„ฐ๋ฏธ๋„์— ์•ˆ๋‚ด ๋ฌธ๊ตฌ๊ฐ€ ์ถœ๋ ฅ๋˜๋ฉด ์ •์ƒ์ž…๋‹ˆ๋‹ค.

์ด ๋ ˆํฌ์˜ README์— ์ ํžŒ ์‹ค์ œ ๋ช…๋ น์–ด๋ฅผ ๊ทธ๋Œ€๋กœ ๊ฐ€์ ธ์™”์Šต๋‹ˆ๋‹ค.

// repository documentation