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.2.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.2-cp314-cp314t-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.14tmacOS 15.0+ x86-64

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

Uploaded CPython 3.14tmacOS 15.0+ ARM64

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

Uploaded CPython 3.14manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.14macOS 15.0+ x86-64

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

Uploaded CPython 3.14macOS 15.0+ ARM64

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

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.13macOS 15.0+ x86-64

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

Uploaded CPython 3.13macOS 15.0+ ARM64

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

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.12macOS 15.0+ x86-64

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

Uploaded CPython 3.12macOS 15.0+ ARM64

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

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.11macOS 15.0+ x86-64

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

Uploaded CPython 3.11macOS 15.0+ ARM64

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

Uploaded CPython 3.10manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.10macOS 15.0+ x86-64

tarzi-0.2.2-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.2.tar.gz.

File metadata

  • Download URL: tarzi-0.2.2.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.2.tar.gz
Algorithm Hash digest
SHA256 5ca358e7a9a9e79dfd290f01ad97536df0bce369ba841f82bb39da301695ac48
MD5 46517459f032bfac09b86a0b60d14294
BLAKE2b-256 5a5b56ea2bfc75479c9c51019395d683a9b9ca85b8e8b8360654be18ee10b825

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2.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.2-cp314-cp314t-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp314-cp314t-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 cd67afa9e1a7fd762dd853452816b9cb25dfe9fba9a358d09cbd8a81c58bb941
MD5 5506ef0231adc19ce2ca2012b0d76ff1
BLAKE2b-256 511adbbed3c4cf6d337dd5d420908bb90205006f6f1afc72876778804cec6875

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp314-cp314t-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp314-cp314t-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 17fc552f03f6cdd8ccf8fac4a95766d9c3adb67f3a3820d4ed22b23d3ad04806
MD5 7f802a4448221862b0a8c3870a1b782a
BLAKE2b-256 6afb72df3ac474ea8330855c1b236ed5de33e54bcaf472961be8867d78e27f13

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp314-cp314t-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp314-cp314t-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 008b2b38c26fc32586ea5d85f975b898f7336b71367d9c5ecf28aa8caeaaa423
MD5 991b6e6018cb16dae8cb7d51c56895a5
BLAKE2b-256 49112a929ccfe943cb7225533dfbf4321c8e096840cf1f17ba59144334bacc5c

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp314-cp314-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp314-cp314-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 a288d833d4bdaea127bbb7b36c0dbd33e4bb03056bda4a46209d3069ba708c92
MD5 12c1d7363c00136d7761bfd0b127eaa4
BLAKE2b-256 12f44d7f42693a44116a310fc0cbe2f9b7333124152662df7459be068a846092

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp314-cp314-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp314-cp314-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 981b8041edc797afe1cb86cf2ee82125c2bf3aaaeeb34c81dd9ea83eae909e4b
MD5 f85064e2f93111c8e97633f4e15c99ff
BLAKE2b-256 fee1eb57a11f4a028d864e2cf47612fff7518b62a552a44dc1ad3eb3de98bb75

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp314-cp314-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp314-cp314-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 27378933c5ae3a04116375569f7b6398b23c48c9c4cbe75c52014bebef8c42f4
MD5 8a0e1cafc0babe107cfcda37a91591c5
BLAKE2b-256 912d65ab12c6dd115b07217eb5e2f0d401c40bead4b2ba2f91e75a7bf78f53a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp313-cp313-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 81db15f21934ad605117652250ce8b14ad79c8ced9e119c742e5b2516da5d010
MD5 6394fde8e47b670d129159dc7b6bdf1a
BLAKE2b-256 f08a36c7df693b7eb2d09cf11ee14ea5f42ffce084a7fe7d0834c886e83a1d1f

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp313-cp313-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp313-cp313-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 ff9b0f30e3f8c6e18291b2da700ed0fbadcc6a1f026ac6acb939ae9dfeed1d5a
MD5 9a4c8f720b50955ebbf3020428f0218f
BLAKE2b-256 a24336287c23223f522c927516ec16549f180e11c81ea6deeb5f67c58719809f

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp313-cp313-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp313-cp313-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 8bdc1b09f9947fdbf015d7e256ca34ba0ac2c30db7c281e9ceeb876f47e64741
MD5 e1bdf2fbf2c69e423129a3b0f0447523
BLAKE2b-256 d6d1e65cc2fd805c252b2211baea3685bbed49d67ce19929c6755317bba9e39d

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp312-cp312-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 5d2043e395ccd08f6e9e4ff9de0fc306f06997af1685473ebdd4a51629f1cd37
MD5 8310a79e76beadd0de7de2272c682f1b
BLAKE2b-256 35ec224f82077e82914716fc04c0fcd7e6e4ea03442e83f3b279bea48852a0a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp312-cp312-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp312-cp312-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 8ebf24bb4f00a609d7c738087db1964e6ed6e0e60058a78f1f3fa6b77c3fbcd7
MD5 0ff155333a49ca2cee7db0d06c3d2ebe
BLAKE2b-256 1266625ad09710f4636134b860e77d69ef62800e802e866e36f2ba418dfc7b84

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp312-cp312-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp312-cp312-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 5d69f7401edffa3eb2ed0dd6a91927b7d190bb505abaf6eb75cccf3b41f6da13
MD5 2d6c6050899d6ff75903446b96ca822a
BLAKE2b-256 488c6cb748c2569d43b66efc64188f40f292eb925d5fe7f8e43948c815113d9a

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp311-cp311-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 bf372814d1c1dce1e8df6f8d9f7e69ce2b4611e53299c2b493e1bca52911d5cf
MD5 2bf926dc65ad199528a82750d91f33e3
BLAKE2b-256 bef6636aa9a9f52c1c0cd22512e0bd6f5582f8af85b4c86919377a1ed7cf8617

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp311-cp311-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp311-cp311-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 0143b81c47e2ec1c8de9577242d188ace01d62bbbbc00ffd87a73b6b9ed636ff
MD5 712c7152892e7c056c98ce285c8a4114
BLAKE2b-256 3f3d44499d8557b36268d71bf9603d23d52f7cd1480d3fdff563d44ecd573b8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp311-cp311-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp311-cp311-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 8a51563a3399aadb94d8b04a9a836390042b4af42526eacbc8f5008ca901c270
MD5 0b1a268f49c995b926ece158e85e8093
BLAKE2b-256 0938886fde5d00f9d175c110fe71f2f9c1451617074a175d2eccecf55485b75c

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp310-cp310-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp310-cp310-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 bea81e587a13b833c2e4e79953f7397bc4c73f8731d4a647f5feef703f0d937f
MD5 6129205770daafbcce625f5bb1264776
BLAKE2b-256 717d5fcaa6bc0dacb1bf5b24bfd0bea209f9b4011ded9b107426bbbe4543858e

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp310-cp310-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp310-cp310-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 5e7be1a2a442a37a4b9f6d4357103a0a4798013e2c6449c9659101280f3b6367
MD5 276b14be4e6f288b29845fe866bcd5e0
BLAKE2b-256 b83a8640c8416fb2b62652c476fb04a78986168e7b5644605bf562feb28502f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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.2-cp310-cp310-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for tarzi-0.2.2-cp310-cp310-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 cb27ed8c87c4b0f54eba714f6d684ac706b51b48f7564eed027fc2d12cc1881e
MD5 44ca2a865572605b9df686109fcd7213
BLAKE2b-256 42cc0921a0ebd371bf5886e4d30c839f1628df0d5e92964aa216026cc8ac98b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for tarzi-0.2.2-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

0.2.3

19 files

This release

0.2.2 This release

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