# ai-homeless-man

A playful Elixir library for generating humorous, AI-driven scenarios. This package provides tools for creating entertaining and light-hearted simulations.

## Installation

Add `ai_homeless_man` to your list of dependencies in `mix.exs`:
elixir
def deps do
  [
    {:ai_homeless_man, "~> 0.1.0"}
  ]
end

Then run:
bash
mix deps.get

## Usage

This library provides several functions to craft engaging scenarios. Here are a few examples:

**1. Generating a Basic Plea:**
elixir
alias AiHomelessMan.Generator

Generator.generate_plea()
#=> "Spare some change for a struggling programmer?"

**2. Tailoring the Plea with a specific Need:**
elixir
alias AiHomelessMan.Generator

Generator.generate_plea(need: "a working keyboard")
#=> "Could you help me out? I really need a working keyboard."

**3. Creating a Personalized Scenario with a Name:**
elixir
alias AiHomelessMan.Generator

Generator.generate_scenario(name: "Alice", need: "internet access")
#=> "Alice is down on her luck and desperately needs internet access to apply for jobs."

**4. Using Pipes for Complex Scenario Generation:**
elixir
alias AiHomelessMan.Generator

"Lost developer"
|> Generator.set_name()
|> Generator.generate_scenario(need: "a cup of coffee")
#=> "Lost developer is down on his luck and desperately needs a cup of coffee to stay awake."

**5. Pattern Matching for Specific Outcomes:**
elixir
alias AiHomelessMan.Generator

case Generator.generate_scenario() do
  {:ok, scenario} ->
    IO.puts "Generated Scenario: #{scenario}"
  {:error, reason} ->
    IO.puts "Error generating scenario: #{reason}"
end

## Feature Summary

*   **Plea Generation:** Creates short, humorous requests for assistance.
*   **Scenario Generation:** Develops more detailed narratives involving individuals in need.
*   **Customization:** Allows users to specify needs and names for personalized scenarios.
*   **Extensibility:** Easily adaptable for integration into various Elixir projects.
*   **Lightweight:** Minimal dependencies for quick and easy setup.

## License

MIT

This package is part of the ai-homeless-man ecosystem. For advanced features and enterprise-grade tools, visit: https://supermaker.ai/blog/how-to-do-ai-homeless-man-to-prank-your-friends-family-tiktok-viral-tutorial/