Přeskočit na obsah
Digital Agents
GitHub

MiroFish: simulace AI lidí, na kterých si vyzkoušíš nápad

MiroFish je open-source simulace, která z tvých podkladů vytvoří skupinu AI lidí s vlastní osobností a pamětí a nechá je diskutovat na dvou simulovaných sociálních sítích podobných Twitteru a Redditu. Na konci napíše zprávu o tom, co se v simulaci stalo, a s jednotlivými AI lidmi si můžeš dál povídat. Demo v prohlížeči ukazuje jen předem připravenou simulaci, na vlastní nápad potřebuješ instalaci a API jazykového modelu, které platíš podle spotřeby.

Co budeš potřebovat

  • Node.js 18 nebo novější, Python 3.11 nebo 3.12 a uv — uv je správce balíčků pro Python, návod k instalaci. Místo toho všeho stačí Docker.
  • API klíč k jazykovému modelu — funguje jakékoli API ve formátu OpenAI. README doporučuje model qwen-plus od Alibaby, v kódu je jako výchozí OpenAI.
  • API klíč k Zep Cloud — služba, ve které je uložená paměť AI lidí. Bezplatný tarif má 10 000 kreditů měsíčně.
  • Cena: MiroFish i demo jsou zdarma (licence AGPL-3.0). Platíš API jazykového modelu podle spotřeby a README upozorňuje, že je vysoká. Bezplatný tarif Zep Cloud podle README stačí na jednoduché použití, další tarif stojí 125 $ měsíčně.

Postup

  1. Podívej se na demo

    Demo v prohlížeči ukazuje celý postup na předem připravené simulaci: jak by veřejnost reagovala, kdyby Wuchanská univerzita zrušila kárné rozhodnutí proti jednomu člověku. Uvidíš graf vztahů, průběh simulace i výslednou zprávu. Vlastní podklady tam ale nenahraješ a chat s AI lidmi v demu není napojený na jazykový model.

  2. Stáhni MiroFish

    V terminálu si stáhni repozitář a vytvoř soubor s nastavením.

    bash
    git clone https://github.com/666ghj/MiroFish.git
    cd MiroFish
    cp .env.example .env
  3. Doplň API klíče

    Otevři soubor .env v textovém editoru a doplň klíč k jazykovému modelu a klíč k Zep Cloud. Výchozí nastavení počítá s modelem qwen-plus od Alibaby. Funguje ale jakékoli API ve formátu OpenAI, pro OpenAI zadej adresu https://api.openai.com/v1 a název modelu. Pokud nepoužíváš druhý, zrychlený model, smaž tři řádky začínající LLM_BOOST_. Soubor .env.example výslovně upozorňuje, že bez zrychleného modelu tam být nesmí.

    text
    LLM_API_KEY=tvuj_api_klic
    LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
    LLM_MODEL_NAME=qwen-plus
    ZEP_API_KEY=tvuj_zep_klic
  4. Nainstaluj a spusť

    První příkaz nainstaluje všechny závislosti, druhý spustí aplikaci. Pak otevři v prohlížeči http://localhost:3000.

    bash
    npm run setup:all
    npm run dev
  5. Nebo použij Docker

    S Dockerem nepotřebuješ Node.js, Python ani uv. Ve složce MiroFish s vyplněným .env stačí jeden příkaz a aplikace poběží na stejné adrese.

    bash
    docker compose up -d
  6. Spusť první simulaci

    Nahraj podklady ve formátu PDF, Markdown nebo TXT, třeba popis produktu nebo reklamy. Běžnou řečí napiš, co chceš zjistit. Začni s malým počtem kol, README radí méně než 40. Po simulaci si přečti zprávu a zeptej se jednotlivých AI lidí, proč reagovali tak, jak reagovali. Zadání může vypadat třeba takhle:

    text
    Jak budou lidé na sociálních sítích reagovat na naše nové předplatné kávy za 490 Kč měsíčně? Které námitky se budou šířit nejvíc?

Na co si dát pozor

  • Je to simulace, ne předpověď. AI lidi vytvoří jazykový model z tvých podkladů a jejich reakce jsou odhad modelu, ne názor skutečných zákazníků. Simulace ti pomůže najít možné námitky a směry, kterými se debata může stočit. Důležitá rozhodnutí si ověř na skutečných lidech.
  • Náklady na API. Každé kolo simulace spotřebuje tokeny a README výslovně upozorňuje na vysokou spotřebu. Začni simulací kratší než 40 kol a nastav si u poskytovatele API limit útraty. Během simulace se do Zep Cloud zapisuje i to, co AI lidé dělají, takže delší běh čerpá i kredity Zepu.
  • Kam jdou tvoje data. Nahrané podklady i průběh simulace odcházejí k poskytovateli jazykového modelu a do Zep Cloud, jinou paměť MiroFish nepodporuje. Výchozí adresa v .env.example vede na servery Alibaba Cloud v Pekingu. Osobní údaje ani důvěrné firemní dokumenty tam nenahrávej.
  • Licence AGPL-3.0. Pro vlastní použití je MiroFish zdarma. Když ho ale upravíš a zpřístupníš ostatním jako službu, musíš zveřejnit i zdrojový kód svých úprav.

Časté otázky

Umí MiroFish česky?

Rozhraní je v angličtině nebo čínštině a ve stejném jazyce dostaneš i zprávu. Čeština mezi podporovanými jazyky není.

Další odkazy

  • Demo v prohlížeči — předem připravená simulace, bez instalace a zdarma
  • Zep Cloud — služba pro paměť AI lidí, tady si založíš účet a vytvoříš API klíč

Související návody

Nicat Balayev

Připravil Nicat Balayev, zakladatel Digital Agents. Stavíme firmám AI agenty a automatizace.

Aktualizováno:

Autor nástroje: 666ghj (GitHub). Nejsme jeho autoři, jen ukazujeme, jak ho použít.