Update README.md

README.md

@@ -7,4 +7,30 @@ language:
 - en
 base_model:
 - DavidAU/Qwen3-42B-A3B-Grande-Claude-4.5-Opus-High-Reasoning-2507
----
+---
+# Fred-42B
+
+Fred-42B is a Mermaid diagram-focused fine-tune built on top of [DavidAU/Qwen3-42B-A3B-Grande-Claude-4.5-Opus-High-Reasoning-2507](https://huggingface.co/DavidAU/Qwen3-42B-A3B-Grande-Claude-4.5-Opus-High-Reasoning-2507), trained primarily for generating accurate, well-structured diagrams in academic and STEM contexts.
+
+## Intended Use
+
+Fred-42B was developed to assist students and professionals in producing Mermaid-syntax diagrams, with a particular focus on **Entity-Relationship (ER) diagrams** for database design, as well as flowcharts, sequence diagrams, and class diagrams commonly used in computer science and informatics coursework.
+
+The model is designed to integrate naturally into note-taking and knowledge management workflows, including tools like [Obsidian](https://obsidian.md/) via its native Mermaid rendering support. This makes it well-suited as an in-context diagram assistant for STEM-related academic tasks.
+
+## Training Data
+
+The model was fine-tuned on two datasets:
+- **[TeichAI/claude-4.5-opus-high-reasoning-250x](https://huggingface.co/datasets/TeichAI/claude-4.5-opus-high-reasoning-250x):** High-reasoning instruction data used to reinforce structured analytical output.
+- **[TendieLabs/Tender_Mermaid_Training_V1](https://huggingface.co/datasets/TendieLabs/Tender_Mermaid_Training_V1):** Mermaid diagram-specific training examples covering a range of diagram types and complexity levels.
+
+## Capabilities
+
+- ER diagram generation from natural language descriptions or schema definitions
+- General Mermaid diagram generation (flowcharts, sequence, class, and state diagrams)
+- STEM academic task assistance with structured, diagram-augmented responses
+- Obsidian-compatible output formatting
+
+## Limitations
+
+Fred-42B is optimized for diagram generation tasks and may underperform on general-purpose reasoning tasks relative to the base model. Output quality is best when prompts include clear schema definitions, entity lists, or explicit diagram type requests.