README.md

---
license: mit
language:
- pt
pipeline_tag: text-generation
tags:
- mythramind
- synapse
- retrieval
- bm25
- markov
- context-memory
- pt-br
---

<p align="center">
  <img src="logo.png" width="520"/>
</p>

<h1 align="center">MythraMind</h1>

<p align="center">
  <b>V1 · Synapse+</b><br>
  Hybrid AI Engine para geração, recuperação e composição de texto
</p>

<p align="center">
  <i>Formato do modelo: <b>.mind</b></i>
</p>

---

## Visão geral

**MythraMind V1** é a primeira versão pública da engine, construída para unir recuperação inteligente, composição textual e memória de contexto em um sistema leve, rápido e totalmente orientado a texto.

Esta versão não foi feita para “saber tudo”. Ela foi projetada para fazer bem o que importa em conversa e criação textual: responder com mais coerência, manter continuidade, variar sem se perder e tomar decisões melhores na hora de compor saída.

O coração da arquitetura é o fluxo **Synapse+**, com módulos independentes para:
- composição por frases,
- memória de sessão,
- expansão anafórica,
- detecção de mudança de assunto,
- BM25+ dinâmico,
- busca fuzzy por trigramas.

---

## Estado do projeto

**Versão atual:** V1  
**Status:** em evolução ativa  
**Preview público:** previsto até **10 de maio**  
**Benchmark oficial:** **MythraMind Mantra**  
**Preview benchmark model:** **MythraMind Recupert**

---

## O que é o MythraMind Mantra

**MythraMind Mantra** é o benchmark próprio do projeto.

Ele foi criado para testar o MythraMind contra modelos de ponta em tarefas bem específicas, especialmente em português, incluindo:

- criação de histórias;
- manutenção de conversa;
- decisões autônomas;
- consistência de contexto;
- variação sem repetição;
- resposta a queries curtas e dependentes de contexto;
- recuperação com erros de digitação;
- composição textual híbrida.

O objetivo não é só medir “quem responde mais bonito”, mas sim avaliar **utilidade real**, **coerência**, **continuidade**, **adaptação** e **comportamento em tarefas de texto**.

---

## MythraMind Recupert

**MythraMind Recupert** será o modelo de preview.

Ele serve como uma amostra pública da direção da V1, mostrando o comportamento-base da engine antes da liberação completa do modelo principal.

A ideia do preview é permitir:
- avaliação inicial da arquitetura;
- comparação com o benchmark Mantra;
- coleta de feedback;
- observação do estilo de resposta;
- validação de estabilidade e coerência.

---

## O que a V1 traz

### SentencePool
Em vez de escolher frases aleatórias de uma única resposta, a engine monta um pool com frases de várias respostas e reavalia cada uma individualmente. Isso melhora a qualidade da composição final.

### Memória de sessão
A engine registra o que já foi dito e reduz repetição entre turnos, evitando respostas muito parecidas em sequência.

### Expansão anafórica
Perguntas curtas como “e aí?”, “continua” ou “por quê?” passam a usar o contexto anterior de forma automática.

### Detecção de topic shift
Quando o assunto muda, a engine reduz a influência do contexto antigo para evitar poluição de tópico.

### BM25+ dinâmico
Os parâmetros de busca se adaptam ao tamanho da query, melhorando precisão em consultas curtas e longas.

### Char Trigram Fuzzy
O sistema tolera erros de digitação e ainda encontra o conteúdo correto sem depender de listas manuais enormes de sinônimos.

---

## Formato do modelo

O modelo segue o formato:

```txt
.mind
```

Esse formato representa o empacotamento lógico do MythraMind, com foco em:
- estado interno;
- dados do brain;
- configuração de sessão;
- versão da engine;
- metadados do modelo.

---

## Capacidades principais

MythraMind V1 foi pensado para se sair bem em:

- conversas longas;
- criação de histórias;
- respostas com continuidade;
- variação textual;
- manutenção de personalidade;
- recuperação por contexto;
- comportamento mais “vivo” e menos mecânico;
- decisões autônomas simples dentro da conversa.

---

## Arquitetura resumida

### M — Motor / Memória longa
Contém estruturas compiladas durante o treino ou importação do modelo:
- brain;
- clauses;
- triIdx;
- idfCache;
- vocabulário e estatísticas de recuperação.

### S — Sessão / Memória curta
Contém o estado temporário da conversa:
- ctxVec;
- usedHashes;
- mutSlots;
- entities;
- lastQueryToks;
- configuração de geração.

---

## Benchmark próprio

O **MythraMind Mantra** vai medir o sistema em cenários como:

- gerar uma história a partir de uma ideia curta;
- manter uma conversa por vários turnos sem se contradizer;
- tomar uma decisão autônoma coerente;
- recuperar conteúdo relevante com pouca informação;
- lidar com erros de digitação;
- variar respostas sem perder o assunto;
- evitar repetição em conversas longas.

Os testes serão comparados com modelos de ponta voltados para texto, usando critérios de utilidade, consistência e naturalidade.

---

## Roadmap

### V1
- preview público;
- benchmark Mantra;
- estabilização da arquitetura;
- ajustes de coerência e recuperação.

### Próximas versões
- refinamento de composição;
- melhora de memória contextual;
- ampliação do benchmark;
- mais robustez em diálogo e criação textual.

---

## Observações

MythraMind não foi desenhado para ser um modelo genérico de “resposta para tudo”.  
A proposta é ser forte em texto, conversa, composição e adaptação contextual, com uma estrutura leve e modular.

---

## Preview

O primeiro preview do projeto será lançado como:

**MythraMind Recupert**

Até **10 de maio**, a ideia é disponibilizar uma versão de demonstração da V1 para apresentar o comportamento inicial da engine.

---

## Licença

MIT