Repolode
Enviar
a16z-infra

a16z-infra/ai-town

Kit inicial com licença MIT para implantar e personalizar o AI Town, uma cidade virtual onde personagens de IA vivem, conversam e socializam, criado com Convex.

Ver no GitHubSite
Estrelas
10,676
Forks
1,227
Issues abertas
75
Último commit
há 2 meses

O que é?

AI Town é uma cidade virtual onde personagens de IA vivem, conversam e socializam. O projeto é um kit inicial pronto para implantação, que você pode usar para criar sua própria versão, inspirado no artigo de pesquisa Generative Agents. Escrito em TypeScript, foi projetado para ser estendido e conta com um backend Convex que oferece estado global compartilhado, transações e um mecanismo de simulação.

A stack usa Convex como mecanismo de jogo, banco de dados e ferramenta de busca vetorial, com Clerk como opção para autenticação. Os personagens são configurados em arquivos de dados, e o mapa pode ser criado com Tiled e convertido usando um script fornecido. O modelo de chat padrão é o llama3, executado pelo Ollama, mas o app também pode usar Together.ai ou qualquer API compatível com OpenAI. A música de fundo pode ser gerada pelo Replicate, e a renderização do frontend usa PixiJS.

As opções de configuração incluem o fluxo padrão na nuvem do Convex, uma configuração Docker Compose auto-hospedada e a implantação no Fly.io. O frontend pode ser implantado no Vercel, e o Ollama local pode ser exposto a um backend na nuvem por meio de um túnel como ngrok ou Tunnelmole.

Recursos principais

  • 01Cidade simulada onde personagens de IA conversam e socializam entre si.
  • 02Criado com Convex, com estado compartilhado, transações e um mecanismo de simulação.
  • 03Compatível com inferência local via Ollama, além de Together.ai e APIs compatíveis com OpenAI.
  • 04Personagens, sprite sheets e mapas personalizáveis, editados com Tiled.
  • 05Geração opcional de música de fundo via Replicate.
  • 06Pode ser executado localmente, com Docker Compose, ou implantado na nuvem do Convex, no Fly.io e no Vercel.

Casos de uso

  • Aprender como agentes generativos podem simular comportamento social em um mundo virtual.
  • Criar um protótipo de simulação multiagente ou de um jogo multiplayer pequeno com personagens controlados por LLMs.
  • Criar uma cidade virtual personalizada, com seus próprios personagens, histórias e mapa.
  • Experimentar com LLMs locais pelo Ollama em uma configuração autocontida.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/a16z-infra/ai-town.git
  2. 2

    Acesse a pasta do projeto e instale as dependências

    cd ai-town && npm install
  3. 3

    Inicie o app localmente (entre no Convex se solicitado)

    npm run dev
  4. 4

    Abra http://localhost:5173 no navegador

Antes de usar

  • A configuração padrão exige uma conta gratuita do Convex e uma instalação local do Ollama com llama3 para o chat com IA.
  • Opções de LLM na nuvem, como OpenAI ou Together.ai, exigem chaves de API pagas.
  • Usuários do Windows precisam do WSL2 e de um ambiente no estilo do Ubuntu.

Tópicos

#ai#llm#simulation#multi-agent#typescript#convex#game#ollama

Perguntas frequentes

O que é ai-town?
Kit inicial com licença MIT para implantar e personalizar o AI Town, uma cidade virtual onde personagens de IA vivem, conversam e socializam, criado com Convex. AI Town é uma cidade virtual onde personagens de IA vivem, conversam e socializam. O projeto é um kit inicial pronto para implantação, que você pode usar para criar sua própria versão, inspirado no artigo de pesquisa Generative Agents. Escrito em TypeScript, foi projetado para ser estendido e conta com um backend Convex que oferece estado global compartilhado, transações e um mecanismo de simulação.
ai-town é gratuito? Qual é a licença?
ai-town é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ai-town ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de ai-town foi em 26 de ago. de 2026.
Para que posso usar ai-town?
Aprender como agentes generativos podem simular comportamento social em um mundo virtual. Criar um protótipo de simulação multiagente ou de um jogo multiplayer pequeno com personagens controlados por LLMs. Criar uma cidade virtual personalizada, com seus próprios personagens, histórias e mapa. Experimentar com LLMs locais pelo Ollama em uma configuração autocontida.
Como instalar ai-town?
Clone o repositório: git clone https://github.com/a16z-infra/ai-town.git Acesse a pasta do projeto e instale as dependências: cd ai-town && npm install Inicie o app localmente (entre no Convex se solicitado): npm run dev Abra http://localhost:5173 no navegador
Onde consigo ai-town?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/a16z-infra/ai-town

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados