Skip to main content
Tarzi Logo

tarzi

Crate Version PyPI Version Rust CI Python CI PyV

License X Follow

⚠️ Current Limitation: Currently only search engines without anti-bot protection are workable, such as DuckDuckGo and Brave. We require advanced features to bypass anti-bot measures for other engines like Google and Bing.

🐒 Tarzi is a unified search interface designed for Retrieval-Augmented Generation (RAG) and agentic systems built on large language models. Search is a core functionality in these systems, yet most search engine providers (SEPs) impose API paywalls or strict rate limits. Tarzi, empowered by browser automation and web crawling technologies, removes these barriers by supporting token-free queries across multiple search engines. With a single dependency, you can integrate and switch between different SEPs as needed—seamlessly and efficiently.

Tarzi Logo

⚙️ Core Capabilities

  • 🦀 Dual Implementation: Native Rust library and Python wrapper with CLI tools
  • 🔄 Content Conversion: Convert raw HTML into Markdown, JSON, or YAML, which is ready for LLMs
  • 🔍 Search Integration: API → plain HTTP → headless browser cascade with a unified result format
  • 🧠 Multi-Engine Support: Bing, Google, Google Serper, DuckDuckGo, Brave, Baidu, Sogou Weixin, Tavily, Google AI (Gemini), SearxNG
  • 🛡️ Proxy Support: Bypass network bans using proxy support to access global SEPs
  • 🚀 End-to-End Workflow: Full pipeline from search to content extraction for AI and automation use cases

🧪 Advanced Features (Under dev.)

  • 🕵️‍♂️ Anti-Bot Evasion: Use fingerprint spoofing, proxy rotation, and human-like actions to avoid detection
  • 🧠 Smarter Queries: Improve search results with prompt rewriting and intent-aware queries
  • 🔗 Workflow Automation: Chain steps like search, click, form fill, and scraping into automated flows

Install

pip install tarzi

CLI Commands

Tarzi provides two command-line interfaces:

  • tarzi: Native Rust CLI (faster, more efficient)
  • pytarzi: Python CLI (easier to extend, same functionality)

Both CLIs support the same commands and configuration precedence.

Usage Examples

  • Examples in Python and Rust: examples
  • Search cascade demo: cargo run --example search_cascade / python examples/search_cascade.py
  • Serper (Google API): set SERPER_API_KEY, then cargo run --example search_engine_serper

Search configuration

Breaking change: tarzi.toml / ~/.tarzi.toml are removed. Configure with env vars (see .env.example):

export TARZI_SEARCH_ENGINE=duckduckgo,bing,brave  # default; or single engine / other ordered list
export TARZI_SEARCH_BROWSER=true           # false disables browser fallback (default true)
# Engine API keys (tarzi has no product API key):
export BRAVE_API_KEY=...                   # or SERPER_API_KEY for google_serper

Access cascade (always): API (if credentials present) → plain HTTPbrowser (if enabled). API-only engines without keys are skipped before any network call. google is web-only; Google API results use google_serper (alias serper).

Alternatives

Contributors

Thank you ❤ all human and non-human contributors.

tarzi contributors

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tarzi-0.2.3.tar.gz (2.1 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

tarzi-0.2.3-cp314-cp314t-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ ARM64

tarzi-0.2.3-cp314-cp314t-macosx_15_0_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.14tmacOS 15.0+ x86-64

tarzi-0.2.3-cp314-cp314t-macosx_15_0_arm64.whl (4.2 MB view details)

Uploaded CPython 3.14tmacOS 15.0+ ARM64

tarzi-0.2.3-cp314-cp314-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ ARM64

tarzi-0.2.3-cp314-cp314-macosx_15_0_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.14macOS 15.0+ x86-64

tarzi-0.2.3-cp314-cp314-macosx_15_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.14macOS 15.0+ ARM64

tarzi-0.2.3-cp313-cp313-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

tarzi-0.2.3-cp313-cp313-macosx_15_0_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.13macOS 15.0+ x86-64

tarzi-0.2.3-cp313-cp313-macosx_15_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.13macOS 15.0+ ARM64

tarzi-0.2.3-cp312-cp312-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

tarzi-0.2.3-cp312-cp312-macosx_15_0_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.12macOS 15.0+ x86-64

tarzi-0.2.3-cp312-cp312-macosx_15_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.12macOS 15.0+ ARM64

tarzi-0.2.3-cp311-cp311-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

tarzi-0.2.3-cp311-cp311-macosx_15_0_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.11macOS 15.0+ x86-64

tarzi-0.2.3-cp311-cp311-macosx_15_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.11macOS 15.0+ ARM64

tarzi-0.2.3-cp310-cp310-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.28+ ARM64

tarzi-0.2.3-cp310-cp310-macosx_15_0_x86_64.whl (4.4 MB view details)

Uploaded CPython 3.10macOS 15.0+ x86-64

tarzi-0.2.3-cp310-cp310-macosx_15_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.10macOS 15.0+ ARM64

File details

Details for the file tarzi-0.2.3.tar.gz.

File metadata

  • Download URL: tarzi-0.2.3.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tarzi-0.2.3.tar.gz
Algorithm Hash digest
SHA256 b042196666a41096347518b7a5136903718738e2b55304dd5b74a9033c5b64f3
MD5 aef4fb5d369640ed7b9eddc68c352fbd
BLAKE2b-256 456856dfbd40f46e111412641059136bfbcf7c66b3a28019cebb53036ab1c3ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3.tar.gz:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp314-cp314t-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp314-cp314t-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 1a5200d2f35ffe0d4827a57b5a41191476b4340a8547e9752b36fa2f18aa1db3
MD5 e56321d6e0f235892cfe93946d00843b
BLAKE2b-256 bcbf4b7cd907010ff99a2c64d4023a8395f48073b8d74743ca41534702d533a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp314-cp314t-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp314-cp314t-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp314-cp314t-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 add5fe0bb721a0dca2b2a8078805d156ef6dac0dd8ed144ab765f98de7e71eef
MD5 35b80626cfb1a86d90fa435b10666db5
BLAKE2b-256 50bfa9853ee27d876558f37db120d9b6ae080b3a8cb3827f2eecfb54d3b55993

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp314-cp314t-macosx_15_0_x86_64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp314-cp314t-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp314-cp314t-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 c69ff2e1cc45fca747323ef60f1d7a7f1f6332cb927b85fb6a65bcb8fc87e5a8
MD5 b05ee4dfc68a7fb9a05544bf09939449
BLAKE2b-256 91b6d761f11ca4a834fdd0e3a4c2220460dd5efb293ece57c86529b046288afc

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp314-cp314t-macosx_15_0_arm64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp314-cp314-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp314-cp314-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 725e830a59ba7cd06d2fdc478a5b864b73c3086b1e7735b831398c93572ab496
MD5 0503e30ca7ab72065014c486e57344df
BLAKE2b-256 de08588791eae28cf07e86a2fe9350206a6fedef9f5eaf8918427a7afbe945ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp314-cp314-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp314-cp314-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp314-cp314-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 ca0a95f4202f0dc8ed734cc18dbce697dbd1f5f855e823f6510b66db766d0235
MD5 1388e66fab69b2d5b60aec93944d6a03
BLAKE2b-256 a21a40717bfd43c24f48871b4b8a487057d3a0e1b052644fd43522f648df6fb8

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp314-cp314-macosx_15_0_x86_64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp314-cp314-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp314-cp314-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 96f68f5f37cc9bb74a068804dc0919ff34c95bd9292ed4de4b25945efa2cb0ba
MD5 41cdd28201966200f8c7c832595f7467
BLAKE2b-256 98faf51bb9478722322dbb53441ca52b3c6880813e1dad0857095a0cce9fd61a

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp314-cp314-macosx_15_0_arm64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp313-cp313-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 27298d85a1f8c4ec1eb199eb12fb6cda810813534656aa01e5ab47286d89dae3
MD5 7ddbf9a29eb28f1e93f96eade3a809e8
BLAKE2b-256 7c301aa8d7c2d1dc4a3f2b2372249ed9fddae8b01d2d5a25f5b8a2f5a5ad34c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp313-cp313-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp313-cp313-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp313-cp313-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 be2202d34da87178d2558ca00c67dacece7c7dec0b0e363c52b447e95196e2e4
MD5 b8845a8b140d4de8f9a2e2b40becaaa5
BLAKE2b-256 3e996c7be7fd7e41058c97377cc819d63900c5905911ee3544ee0eab75615ca8

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp313-cp313-macosx_15_0_x86_64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp313-cp313-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp313-cp313-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 58529e00d39fae9c14df9f90fd9955cfd74565e7337b14ce90f70310291d1300
MD5 8a9840295bbeb6fce0b83e6b521d70a0
BLAKE2b-256 51b8af163593ae309c106bd89c6010fef92f73f4a8a02d4c2c7faade70839ba7

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp313-cp313-macosx_15_0_arm64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp312-cp312-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 4d199074321685f4dc5cc86eea2b210abde69d01f6798f81796d5ef3223f019d
MD5 654b60c359f4182ca573800abf402758
BLAKE2b-256 a20c2bf08b2fba5aaa639a02a1eb15e3343c5fcda06ceb79f0be0bd23741288d

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp312-cp312-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp312-cp312-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp312-cp312-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 eb9ef49a54f68352a1d13b00ee395b39ec955e36f3b58dbf3b8296ad3609e25e
MD5 92904950df7fbd9d6a617bde6a5c7175
BLAKE2b-256 14350494f974c03c3085c65f84d55c78b66048d06e121293570ffebe5e0b7fc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp312-cp312-macosx_15_0_x86_64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp312-cp312-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp312-cp312-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 e036578114691f8bf1f997017a96ae6d74d68cc0fb69f9b3c294fa434c55eb97
MD5 3d3889c13ea58d8df2becd7d08188daa
BLAKE2b-256 552dc7f3418112f2daceedd6623982aac92ab4d447b8a12a4568bf301ca3331a

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp312-cp312-macosx_15_0_arm64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp311-cp311-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 0960c7f2028890a51d443f7c1443b1fef70212f2f54ee6ef562069a3307e6909
MD5 a17ceb5da55af7fa625ca58178bb070a
BLAKE2b-256 91b2ca619a912c9a2d47d39474f54332dc24e34ca1be66d6f4c3b655fb7a1119

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp311-cp311-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp311-cp311-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp311-cp311-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 b0e337752d78acd1e80d60bf83c61f929a02fbff09d1c0f69b5b21decd9d463d
MD5 75ea6e9ad6822918b3b8db0f42892531
BLAKE2b-256 29525b734948f2b148b26c0ba31e48cf3e805d320817910c2c8c8a4d08f4f228

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp311-cp311-macosx_15_0_x86_64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp311-cp311-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp311-cp311-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 5d69027ab7d723a55acdce65c4d65fd8d342367fd53821116d6969f7a3a134cb
MD5 5499ead63dbad87928686229423b9948
BLAKE2b-256 f7d19e3fb3b534565f97718b3239353cbd96630da83622139afa46fda21630e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp311-cp311-macosx_15_0_arm64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp310-cp310-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp310-cp310-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 b578034cd15a8fee46e189bab5757bd86dba58fb84a3da4bd2245d70916f0f9f
MD5 09aafa5141ae298b6a4a7e008f81a81a
BLAKE2b-256 3570b1e441a3bcb67e3ccb3592d2b12d43c99c95cf3cb524e17717cb6e6fe9fd

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp310-cp310-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp310-cp310-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp310-cp310-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 95a939307f58945c23ce07b807bfb4d0249fc795b7dc5fc33ced67233c7252fb
MD5 41e635b9c9314b760a38724bf92b4154
BLAKE2b-256 bb76beb229a134326c7fecbae8d0f6f66c1b886efaac1128ee11039d2b61db07

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp310-cp310-macosx_15_0_x86_64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tarzi-0.2.3-cp310-cp310-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.3-cp310-cp310-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 7412b22ebf65aee1951bbeca554c8267a5d82cc2641fe84f040432a86a53fb6b
MD5 8eaef50017356f050731e1b173418015
BLAKE2b-256 e1d32d8f5b5d739c920244166541c3c09f6c71184673296023abce50d754f1f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.3-cp310-cp310-macosx_15_0_arm64.whl:

Publisher: publish.yml on mirasoth/tarzi

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.3 This release

19 files

0.2.2

19 files

0.2.1

19 files

0.2.0

19 files

0.1.11

19 files

0.1.10

19 files

0.1.9

18 files

0.1.6

24 files

0.1.5

24 files

0.1.3

14 files

0.0.21

12 files

0.0.15

12 files

0.0.12

12 files

0.0.11

12 files

0.0.10

12 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page