tarzi 0.2.3

Rust-native lite search for AI applications
Documentation
Examples
========

Real-world examples and use cases for tarzi.

Getting Started
---------------

All examples are available in the ``examples/`` directory of the repository:

.. code-block:: bash

   git clone https://github.com/mirasoth/tarzi.git
   cd tarzi

   # Python examples
   python examples/basic_usage.py
   python examples/search_cascade.py
   python examples/search_engine_serper.py
   python examples/sogou_weixin_search.py

   # Rust examples
   cargo run --example basic_usage
   cargo run --example search_cascade
   cargo run --example search_engine_brave
   cargo run --example search_engine_serper
   cargo run --example search_engine_default

Example Catalog
---------------

**Search access cascade**
   ``search_cascade`` (Rust / Python) — browser toggle and multi-engine failover.
   Optional: ``BRAVE_API_KEY``, ``SERPER_API_KEY``.

**Brave cascade**
   ``search_engine_brave`` — Brave with API → HTTP → browser (API when keyed).

**Google via Serper**
   ``search_engine_serper`` (Rust / Python) — API-only ``google_serper`` (requires ``SERPER_API_KEY``).
   Requires ``SERPER_API_KEY``.

**Default engine**
   ``search_engine_default`` — uses env/defaults (``duckduckgo,bing,brave`` failover + cascade).

**Sogou Weixin**
   ``sogou_weixin_search`` — WeChat article search via Sogou.

**Basics**
   ``basic_usage``, ``simple_usage``, ``browser_driver_usage`` — fetch, convert, and search wiring.

Documentation Examples
----------------------

.. toctree::
   :maxdepth: 2

   api_search