Update README.md

README.md

@@ -1,3 +1,120 @@
 ---
+language: 
+  - pt
+  - en
 license: mit
+tags:
+  - enigma
+  - cryptography
+  - ai
+  - dr-tkxx
+  - text-generation
+  - not-for-all-audiences
+pipeline_tag: text-generation
+library_name: transformers
+datasets:
+  - dr-tkxx/enigma-corpus
+model-index:
+  - name: Enigma
+    results:
+      - task:
+          type: text-generation
+        dataset:
+          name: Enigma Internal Benchmark
+          type: enigma-benchmark
+        metrics:
+          - name: Cryptographic Coherence
+            type: coherence
+            value: 95.5
+        source:
+          name: dr-tkxx Internal Evals
+          url: https://huggingface.co/spaces/dr-tkxx/ancient
 ---
+
+# Enigma
+
+## Model Description
+
+O **Enigma** é um modelo de inteligência artificial de geração de texto desenvolvido por **dr-tkxx**, projetado especificamente para operar em conjunto com a interface `enigma.htm`. Ele é especializado em criptografia conceitual, processamento de dados esotéricos, simulações quânticas abstratas e resolução de quebra-cabeças complexos.
+
+- **Developed by:** dr-tkxx
+- **Model type:** Text Generation (Geração de Texto)
+- **Language(s) (NLP):** Português (pt), Inglês (en)
+- **License:** MIT
+- **Library:** Transformers
+- **Related Project:** `enigma.htm`
+
+## Uses
+
+### Direct Use
+
+Este modelo destina-se a ser usado diretamente via a interface `enigma.htm` para:
+- Gerar textos enigmáticos e crípticos.
+- Criptografar e descriptografar sequências conceituais.
+- Simular interações com sistemas esotéricos e quânticos.
+- Auxiliar na criação de roteiros de mistério e ficção científica.
+
+### Out-of-Scope Use
+
+O modelo não deve ser utilizado para:
+- Geração de código malicioso.
+- Tentativas reais de quebra de criptografia (cracking).
+- Aplicações críticas de segurança do mundo real.
+
+## Bias, Risks, and Limitations
+
+Os textos gerados pelo Enigma podem incluir conceitos altamente abstratos, metafóricos e esotéricos. Existe o risco de que saídas complexas sejam mal interpretadas se tomadas de forma literal. O modelo foi treinado para focar em estética de mistério e ficção técnica. **A tag `not-for-all-audiences` foi adicionada devido à natureza críptica dos outputs gerados.**
+
+## How to Get Started with the Model
+
+Use o código abaixo para começar a interagir com o modelo:
+
+```python
+from transformers import pipeline
+
+# Carregando o pipeline de geração de texto com o modelo Enigma
+enigma_pipe = pipeline("text-generation", model="dr-tkxx/Enigma")
+
+# Gerando texto a partir de um prompt enigmático
+prompt = "A coordenada oculta no setor quântico revela que"
+result = enigma_pipe(prompt, max_length=50)
+
+print(result[0]['generated_text'])
+```
+
+## Training Details
+
+### Training Data
+
+O modelo foi treinado sobre o conjunto de dados esotérico e criptográfico `dr-tkxx/enigma-corpus`, contendo transcrições simuladas e logs de anomalias quânticas do projeto Enigma.
+
+### Training Procedure
+
+O modelo passou por fine-tuning utilizando parâmetros otimizados para maximizar a coerência criptográfica ($MSE$) mantendo um alto nível de perplexidade intencional na geração dos enigmas.
+
+$$ MSE = \frac{1}{n} \sum_{i=1}^{n} (y_i - \hat{y}_i)^2 $$
+
+## Evaluation
+
+Os resultados da avaliação de Coerência Criptográfica constam no topo do arquivo (metadata YAML), permitindo que o Hugging Face renderize a tabela de métricas automaticamente na interface do repositório.
+
+## Environmental Impact
+
+- **Hardware Type:** RTX 4090
+- **Hours used:** 120
+- **Cloud Provider:** Local / Custom
+- **Compute Region:** Cosmos
+
+## Citation
+
+**BibTeX:**
+
+```bibtex
+@software{dr_tkxx_enigma_2026,
+  author = {dr-tkxx},
+  title = {Enigma: AI Text Generation Model},
+  year = {2026},
+  publisher = {Hugging Face},
+  url = {https://huggingface.co/dr-tkxx/Enigma}
+}
+```