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

What you can do with Asamana

Asamana is an open-source Python and React engine that generates a themed world of AI characters that act on their own and produce a story without a script.

Trended earlier

dreamscroll-lab/asamana 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.

Authorization notice. This tool is dual-use. Only use it on software, sites and systems you own or have explicit permission to test, and follow the relevant licenses and terms of service.

What do you want to do?

4 use cases

  • Replay a finished story without any API keys

    Start Asamana locally and browse the two bundled example worlds with no keys.

    View prompt
    Clone the repo at https://github.com/dreamscroll-lab/asamana, then run ./deploy/asamana.sh start without configuring keys. Report the name of one example world you can browse and the number of characters it lists. Verify that the backend starts without an error about missing API keys.

  • Generate and run a new themed AI story

    Turn one theme into a cast of AI characters and watch their story unfold step by step.

    View prompt
    In the repo https://github.com/dreamscroll-lab/asamana, use a configured <vendor> API key to start the app and create a world from the theme <theme>. Run 3 steps and report the number of characters and the first three narrative lines. Verify that the run stops after the step count you set and does not run indefinitely.

  • Audit a finished world's narrative quality

    Use the developer audit tools to have an LLM review a completed world's story and cognition.

    View prompt
    In the repo https://github.com/dreamscroll-lab/asamana, enable the developer tools and run an audit of type <audit-type> on the world <world-name>. Report the main issues found in the audit report. Verify that the audit ran against a completed world rather than a world still in progress.

  • Trace every LLM call to debug a run

    Inspect prompts, responses, tokens and latency for each stage of a run.

    View prompt
    In the repo https://github.com/dreamscroll-lab/asamana, run a world for 3 steps and open the Trace view. Report the stage name, token count and latency of the first recorded LLM call for one character. Verify that each recorded call is linked to a stage from the five-stage pipeline.

How to use Asamana

  1. Check you have what it needs: Docker with Compose v2 installed (see the Installing Docker section in docs/deployment.md); git to clone the repository; macOS is the recommended platform.
  2. Open dreamscroll-lab/asamana on GitHub and read the README and license.
  3. Run git clone https://github.com/dreamscroll-lab/asamana.git && cd asamana
  4. Run ./deploy/asamana.sh start
  5. When the setup wizard appears, skip the optional API key configuration
  6. Open the app in your browser and select the Xuanwu Gate Incident example world

These steps come from our top use case, Replay a finished story without any API keys, which also has a copy-paste agent prompt.

Asamana alternatives · Best AI repos for Content

About this repo

Requirements

  • Docker with Compose v2 installed (see the Installing Docker section in docs/deployment.md)
  • git to clone the repository
  • macOS is the recommended platform
  • An API key for an OpenAI-compatible LLM vendor, only if you want to create or run worlds
  • A token and spending budget, since each step makes several LLM calls per character
Maintain Asamana? Add the Featured on Deduped badge

Paste this into your README:

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

More badge styles and HTML

Questions about Asamana

What is Asamana?

Asamana is an open-source Python and React engine that generates a themed world of AI characters that act on their own and produce a story without a script. It is an open-source project on GitHub: https://github.com/dreamscroll-lab/asamana.

Who is Asamana for?

Creative writers, game and interactive fiction hobbyists, and developers who want to explore or research emergent multi-agent storytelling.

What can I do with Asamana?

4 use cases so far, for example: Replay a finished story without any API keys; Generate and run a new themed AI story; Audit a finished world's narrative quality. Each has steps and a copy-paste agent prompt.

What do I need to run Asamana?

Docker with Compose v2 installed (see the Installing Docker section in docs/deployment.md); git to clone the repository; macOS is the recommended platform; An API key for an OpenAI-compatible LLM vendor, only if you want to create or run worlds.

What are alternatives to Asamana?

Other hot AI repos in Content: Voice Studio, Anatomy, Comfy UI, Hyperframes, Earshot.

Is Asamana 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.