An open API service indexing awesome lists of open source software.

https://github.com/gabigoubi/narrator.ia

Minecraft AI Narrator (Fabric 1.21.1) featuring 'Edson Calotas': a sarcastic, street-smart virtual character that roasts your gameplay in real-time using local LLM inference. 100% Offline, Drama-Engine driven, and Privacy-focused.
https://github.com/gabigoubi/narrator.ia

ai-narrator edson-calotas fabric-mod game-dev local-ai minecraft ollama python-backend sarcastic-ai voice-synthesis

Last synced: about 1 month ago
JSON representation

Minecraft AI Narrator (Fabric 1.21.1) featuring 'Edson Calotas': a sarcastic, street-smart virtual character that roasts your gameplay in real-time using local LLM inference. 100% Offline, Drama-Engine driven, and Privacy-focused.

Awesome Lists containing this project

README

          

====================================================================
LEIA-ME: COMO LIGAR O NARRADOR IA (v1.3)
====================================================================

[AVISO IMPORTANTE - LEIA ANTES DE TUDO]
Se você usava uma versão antiga (v1.0, v1.1), APAGUE toda a pasta
antiga do servidor. A versão 1.3 possui uma arquitetura nova e arquivos
antigos causarão erros. Faça uma instalação limpa!

---

O mod em si já foi instalado no seu Minecraft pelo CurseForge.
Porém, a Inteligência Artificial roda DENTRO do seu PC, e não na nuvem.
Por isso, você precisa ligar o "motor" dela antes de jogar.

[REQUISITO MÍNIMO OBRIGATÓRIO]: 12GB de Memória RAM.
O sistema possui uma trava de segurança. Se você tiver menos de 12GB,
o programa NÃO VAI ABRIR para evitar que o seu Windows trave por completo.

--- PASSO 1: CONFIGURAR O SEU PC (SOMENTE NA PRIMEIRA VEZ) ---

1. Dê dois cliques no arquivo "1_PRIMEIRA_VEZ.bat".
2. Ele vai abrir os sites oficiais do Ollama e do Python no seu navegador. Baixe e instale os dois.
[REGRA DE OURO]: Na primeira tela de instalação do Python, MARQUE a caixinha
"Add Python 3.11 to PATH" lá embaixo! Se esquecer, o mod não funciona.
3. Após instalar os dois, feche os sites.
4. Dê dois cliques no "1_PRIMEIRA_VEZ.bat" novamente. Agora ele vai baixar
automaticamente todos os componentes necessários do projeto.

--- PASSO 2: COMO JOGAR (SEMPRE QUE FOR ABRIR O MINE) ---

Antes de abrir o jogo, você precisa ligar o servidor da IA:

1. Verifique se o ícone do "Ollama" está rodando no seu Windows (olhe perto do relógio).
2. Dê dois cliques no arquivo: -> 2_INICIAR_IA.bat
3. Deixe a tela preta aberta rodando em segundo plano.

[AVISO SOBRE O PRIMEIRO USO]:
Na primeira vez que rodar o 2_INICIAR_IA.bat, ele baixará o cérebro da IA
(aprox. 4.1 GB). Apenas aguarde. Quando aparecer a mensagem verde
"SISTEMA INICIADO COM SUCESSO", abra o seu Minecraft e se prepare para ser humilhado!

====================================================================
SOLUÇÃO DE PROBLEMAS
====================================================================

- O terminal diz que o Python "não é reconhecido" ou abre a Microsoft Store?
R: Você esqueceu de marcar a caixa "Add to PATH" na instalação. Desinstale o
Python, instale de novo marcando a caixa, reinicie o PC e refaça o Passo 1.

- O terminal exibe um "ERRO CRÍTICO DE HARDWARE"?
R: Seu PC tem menos de 12GB de RAM. O mod bloqueou a inicialização para não
travar sua máquina. Não há como burlar, o mod requer hardware potente.

- Outros Bugs?
Mande na aba de comentários do CurseForge ou abra uma issue no nosso GitHub:
https://github.com/Gabigoubi/Narrator.IA
====================================================================