DEDUPED Hot AI repos, turned into use cases Get 5 a day

What you can do with Yowes

Yowes is a headless MCP server in Python that generates realistic teacher verification documents, such as ID cards, licenses, and letters, for 13 countries.

Trended earlier

hirotomasato/yowes on GitHub

Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk.

What do you want to do?

3 use cases

  • Generate synthetic teacher documents as test fixtures

    Render labeled sample teacher ID cards and letters to test a document-processing pipeline.

    View prompt
    Use the Yowes MCP server in the hirotomasato/yowes repo to produce synthetic teacher documents for <country code> in a test-only folder. Call list_countries_tool and list_schools first, then generate one ID card and one employment letter as PNG files. Verify that each PNG opens and that the file names mark the documents as synthetic.

  • Give an AI agent a country-aware document generator tool

    Connect the Yowes MCP server to an agent that lists countries and schools before generating samples.

    View prompt
    Connect to the yowes MCP server from the hirotomasato/yowes repo over stdio. Call list_countries_tool, then list_schools for <country code>, and report the country codes and school names found. Expected output: a list of valid options with no documents created until asked. Verify that every returned country code matches one of the 13 in the README table.

  • Add a new country generator to the Yowes codebase

    Extend Yowes with a country package that subclasses the base generator and registers itself.

    View prompt
    In the hirotomasato/yowes repo, add a country package for <country name> by subclassing countries.base.CountryGenerator and registering it in countries/__init__.py. Expected output: a working package and a registered country code. Verify that list_countries_tool returns the new code after the server restarts.

How to use Yowes

  1. Check you have what it needs: Python 3.10 or newer; pip, or uv for the uvx route; An MCP client that speaks stdio, such as the clients named in the README.
  2. Open hirotomasato/yowes on GitHub and read the README and license.
  3. Install from source with pip install -e .
  4. Check that bundled fonts and photos resolve with python -c "from countries.utils import load_font, get_profile_photo; print(load_font(30).getname()); print(get_profile_photo((280,340), person_id='x', gender='Male') is not None)" (inferred, check the README)
  5. Start the server over stdio with uvx --from . yowes-mcp
  6. From your MCP client, call list_countries_tool and list_schools to choose a country and school

These steps come from our top use case, Generate synthetic teacher documents as test fixtures, which also has a copy-paste agent prompt.

Yowes alternatives · Best AI repos for Work and operations

About this repo

  • Who it is forBuilt for developers and QA engineers who need realistic synthetic document fixtures, and for agent builders who expose these tools over MCP.
  • Why it is hot
  • LanguagePython
  • Sourcegithub.com/hirotomasato/yowes · Back to Hot repos

Requirements

  • Python 3.10 or newer
  • pip, or uv for the uvx route
  • An MCP client that speaks stdio, such as the clients named in the README
  • A test environment with synthetic data only
Maintain Yowes? Add the Featured on Deduped badge

Paste this into your README:

[![Featured on Deduped](https://dedupedai.com/badge/hirotomasato-yowes.svg)](https://dedupedai.com/use-cases/hirotomasato-yowes/?ref=badge)

More badge styles and HTML

Questions about Yowes

What is Yowes?

Yowes is a headless MCP server in Python that generates realistic teacher verification documents, such as ID cards, licenses, and letters, for 13 countries. It is an open-source project on GitHub: https://github.com/hirotomasato/yowes.

Who is Yowes for?

Built for developers and QA engineers who need realistic synthetic document fixtures, and for agent builders who expose these tools over MCP.

What can I do with Yowes?

3 use cases so far, for example: Generate synthetic teacher documents as test fixtures; Give an AI agent a country-aware document generator tool; Add a new country generator to the Yowes codebase. Each has steps and a copy-paste agent prompt.

What do I need to run Yowes?

Python 3.10 or newer; pip, or uv for the uvx route; An MCP client that speaks stdio, such as the clients named in the README; A test environment with synthetic data only.

What are alternatives to Yowes?

Other hot AI repos in Work and operations: AI Job Search, Solidcraft, Fastbrowse, Awesome AI Agent Platforms, Nautilo.

Is Yowes safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.