CausalCraft

Descrição

Framework Python que utiliza LLMs para gerar, validar causalmente e executar planos de ação para um agente no ambiente Crafter.

Arquitetura

• main.py: Orquestra o ciclo de percepção, planejamento e ação.
• SymbolicWrapper: Converte observações do ambiente em uma representação simbólica JSON.
• LLMPlanner: Gera um sub-objetivo atômico (ex: 'collect_wood') a partir do estado simbólico, utilizando um LLM local via subprocesso.
• CausalValidator: Verifica se um sub-objetivo é causalmente viável com base em pré-condições de inventário e proximidade de entidades.
• SubgoalExecutor: Decompõe o sub-objetivo em ações de baixo nível (navegação e interação) e as executa no ambiente.
• ActionMapper: Mapeia sub-objetivos para alvos e ações específicas do ambiente.

Dependências

• Python 3.x
• crafter: Instalável via pip install crafter.
• Um modelo de linguagem local, acessado pelo script scripts/token_budget_wrapper.py.

Como executar

1. Instale a dependência principal:

   pip install crafter

2. Configure o ambiente do modelo de linguagem para que seja acessível pelo script scripts/token_budget_wrapper.py.
3. Execute o script principal:

   python3 main.py