Skip to content

litanlitudan/skyagi

Repository files navigation

SkyAGI: Emerging human-behavior simulation capability in LLM

SkyAGI.mp4

PyPI

SkyAGI is a python package that demonstrates LLM's emerging capability in simulating believable human behaviors. Specifically, SkyAGI implements the idea of Generative Agents and delivers a role-playing game that creates a very interesting user experience.

Different from previous AI based NPC systems, SkyAGI's NPC generates very believable human responses. The interesting observations in this demo show a huge potential for rethinking game development in many aspects, such as NPC script writing.

To demonstrate this, SkyAGI provides example characters from The Big Bang Theory and The Avengers as a starting point. Users could also define customized characters by creating config json files like customized_character.json For details about the interesting observations, refer to the observations section.

Quick Start

Installation

pip install --upgrade skyagi

Or

make install

How to run

export OPENAI_API_KEY="..."
skyagi
# or
OPENAI_API_KEY="..." skyagi

For example if the OpenAI key is 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, then the exact command would be the following

# make sure no quote around the token
export OPENAI_API_KEY=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
skyagi
# or
OPENAI_API_KEY=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 skyagi

To use example agent configs, download it from here: https://github.com/litanlitudan/skyagi/tree/main/examples (pip install doesn't contain the agent configuration)

An example agent configuration (Sheldon) looks something like this:

{
    "name": "Sheldon",
    "age": 27,
    "personality": "Intelligent, rigid, socially challenged, quirky, and arrogant.",
    "memories": [
        "Sheldon is a theoretical physicist who works at Caltech.",
        "Sheldon has an eidetic memory and is highly intelligent, but struggles with social skills and sarcasm.",
        ...
        "Knock, knock, knock, Penny - This is the specific knock that Sheldon uses when he visits Penny's apartment, which he repeats three times.",
        "Bazinga! - This is Sheldon's catchphrase that he uses to indicate he was joking or playing a prank on someone."
    ],
    "current_status": "Sheldon is at the Cheesecake Factory"
}

Interesting observations in this demo

Here is a screenshot of a live demo using The Big Bang Theory example. demo From the conversation, we can observe three interesting points that have not been widely seen in previous systems:

  1. Leonard remembered that Penny had asked him to persuade Sheldon to go for a hike, which shows the capability of some kind of memory.
  2. Leonard changed his mind after Sheldon whispered to him and even tried to convince Penny to join the scientific effort, which shows that the agents had meaningful progress in the story even without human intervention.
  3. All the responses are quite human-like. As a user, it's quite hard to tell whether it's actually an AI behind the responses.

References

  1. https://arxiv.org/abs/2304.03442
  2. https://python.langchain.com/en/latest/use_cases/agent_simulations/characters.html#create-a-generative-character