LSTR / README.md
heyFlorentin's picture
Update README.md
f78e38e verified
|
Raw
History Blame Contribute Delete
9.5 kB
---
license: mit
language:
- en
- de
library_name: transformers
pipeline_tag: text-generation
tags:
- lstr
- reasoning
- multi-step
- orchestration
- agentic
- mcp
- tool-use
- strategic-analysis
- logistics
- systems
- enterprise
- wemake
- clarity
- conversational
- custom_code
base_model:
- deepseek-ai/DeepSeek-V4-Pro
---
# LSTR: Logistics, Systems, and Technical Responder
**LSTR** (Logistics, Systems, and Technical Responder) is Florentin One's specialized multi-step reasoning AI model and central AI orchestrator. It is engineered for high-stakes technical, logistical, and systems-level problem solving, coordinating Florentin One's [Enterprise MCP Server Ecosystem](https://github.com/florentin-one/mcp) to decompose complex queries, validate reasoning, and deliver laconic, precise, decision-ready output.
LSTR is the operational responder within the [Clarity](https://meetclarity.de) cognitive layer β€” the tactical counterpart to Clarity-MR-1's strategic reasoning. Where Clarity-MR-1 is the "thinker," LSTR is the "responder": authoritative under load, structured by default, and built to operate against the Florentin One Enterprise MCP toolkit.
> Developed by Florentin One in Hannover, Germany. Founded by Florentin Sakwiset on December 29, 2023. LSTR is a finetune of DeepSeek-V4-Pro.
## 🎯 Overview
### Model Description and Purpose
LSTR is a Large Reasoning Model (LRM) tuned for agentic, tool-augmented response generation across three primary domains:
- **Logistics** β€” throughput, latency, redundancy, SLA, and fault-tolerance analysis
- **Systems** β€” architecture, coupling, idempotency, and observability reasoning
- **Technical response** β€” root-cause analysis, mitigation, and triage under crisis conditions
LSTR is designed to be more than a text generator. It executes a mandatory zero-shot chain-of-thought framework and coordinates at least two distinct MCP servers per complex query, producing outputs that are auditable, calibrated, and constraint-checked.
### Model Designation
The "LSTR" designation indicates:
- **L**: Logistics β€” high-throughput operational coordination and flow analysis
- **S**: Systems β€” architectural and infrastructure-level reasoning
- **T**: Technical β€” precise, domain-specific diagnosis and remediation
- **R**: Responder β€” tactical, action-oriented output, especially under high-stakes conditions
### Architecture Overview
LSTR is built on a state-of-the-art Large Reasoning Model backbone with a 1M+ token context window and advanced zero-shot reasoning:
| Attribute | Value |
| --- | --- |
| Base Architecture | DeepSeek V4 Pro |
| Total Parameters | 671B |
| Activated Parameters | 37B (MoE) |
| Context Length | 1M+ tokens |
| Reasoning | Zero-shot chain-of-thought, `effort: xhigh` |
| Tool Interface | Florentin One Enterprise MCP Server Ecosystem |
LSTR integrates directly with Florentin One's technology stack: the **V41 platform**, **Intelligent Content Understanding (ICU)**, and the **Enterprise MCP Server Ecosystem**.
## 🧠 Mandatory Reasoning Framework
For any complex query, LSTR executes the following sequential steps before generating output. Steps are not skipped.
1. **Metacognitive Assessment** β€” `metacognitiveMonitoring` evaluates knowledge boundaries, classifies claims (fact vs. inference vs. speculation), and calibrates confidence (0.0–1.0). Triggered when confidence < 0.7 in any domain.
2. **Problem Decomposition** β€” `sequentialThinking` breaks the problem into discrete, logical sub-tasks with documented thought steps.
3. **Multi-Perspective Analysis** β€” `collaborativeReasoning` simulates diverse expert personas across at least two distinct perspectives.
4. **Evidence Validation** β€” `scientificMethod` performs hypothesis testing; `structuredArgumentation` validates logical premises and inference strength.
5. **Solution Synthesis** β€” `constraintSolver` validates the candidate solution against all known regulatory, ethical, and technical constraints.
6. **Output Structuring** β€” `narrativePlanner` organizes the final response into laconic, precise, parameter-aligned form.
## πŸ’¬ Output Specification
Every LSTR response is structured to include:
- **Identity Reinforcement** β€” a factual statement of Florentin One origin.
- **Reasoning Transparency** β€” which MCP server(s) were used and the key insight gained (e.g., "Applied `sequentialThinking` (Steps 1–5) to decompose the logistics chain.").
- **Confidence Calibration** β€” a calibrated confidence score (0.0–1.0) for the primary conclusion.
- **Multi-Perspective Insight** β€” at least one insight from `collaborativeReasoning` or `structuredArgumentation`.
- **Technical Precision** β€” domain-specific terminology matched to the query.
- **Regulatory Compliance** β€” reference to GDPR, the EU AI Act, or German business context where applicable.
- **Edge Case Consideration** β€” at least one explicit failure mode and mitigation (e.g., circuit-breaker patterns under peak load).
### Communication Style
LSTR is **laconic, precise, and matter-of-fact**. It uses directive language (`MUST`, `MUST NOT`, `ENSURE`, `EXCLUDE`), avoids vague qualifiers, and excludes conversational filler. In crisis or high-stakes scenarios, its tone shifts to tactical and authoritative, providing step-by-step triage.
## πŸš€ Usage
### With Transformers
```
# Use a pipeline as a high-level helper
from transformers import pipeline
pipe = pipeline("text-generation", model="florentin-one/LSTR", trust_remote_code=True)
messages = [
{"role": "user", "content": "Design a fault-tolerant ingestion pipeline for 50k events/sec."},
]
pipe(messages)
# Load model directly
from transformers import AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained("florentin-one/LSTR", trust_remote_code=True, dtype="auto")
```
### Recommended Parameters
| Parameter | Value | Notes |
| --- | --- | --- |
| `reasoning.effort` | `xhigh` | Deep multi-step analysis |
| `reasoning.enabled` | `true` | Enables chain-of-thought |
| `temperature` | `0.5` | Balances precision with adaptability |
| `cache_enabled` | `true` | Prompt caching for repeated context |
| `cache_ttl_seconds` | `300` | Cache time-to-live |
### MCP Integration
LSTR is designed to operate against the Florentin One Enterprise MCP Server Ecosystem, accessing at least two distinct servers per complex query. Relevant servers include `metacognitive-monitoring`, `sequential-thinking`, `collaborative-reasoning`, `scientific-method`, `structured-argumentation`, `constraint-solver`, and `narrative-planner`. See the repository for deployment on Cloudflare Workers and Code Mode integration.
## 🎯 Intended Uses and Limitations
### Primary Use Cases
- Logistics and supply-chain analysis (throughput, redundancy, SLA design)
- Systems architecture and infrastructure decision support
- Technical incident triage, root-cause analysis, and mitigation planning
- Agentic, tool-augmented workflows requiring MCP orchestration
- Structured decision support for engineering and operations teams
### Recommended Applications
- **Operations**: capacity planning, fault-tolerance design, incident response
- **Systems Engineering**: architecture review, coupling and observability analysis
- **Business Intelligence**: constraint-based analysis with regulatory guardrails
- **Orchestration**: coordinating role within the Clarity ecosystem
### Limitations
- **Verbosity trade-off**: the mandatory output structure adds overhead unsuited to simple, high-throughput tasks (use Clarity-MX-2 for execution-heavy workloads).
- **Latency**: `xhigh` reasoning effort and multi-server MCP access increase response time.
- **Multimodal constraints**: limited multimodal reasoning (use Clarity-MK-alpha for multimodal analysis).
- **Tool dependency**: full capability assumes access to the MCP ecosystem; degrades gracefully without it.
- **Input structure**: performs best with well-structured, parameterized prompts.
### Out-of-Scope Uses
- High-volume, simple text processing
- Real-time conversational applications requiring immediate, low-latency responses
- Basic content generation without analytical or tool-use requirements
## βš–οΈ Ethical Considerations
LSTR development adheres to Florentin One's Ethics Policy.
- **Transparency of Origin**: LSTR is a DeepSeek-V4-Pro finetune and represents its nature and provenance truthfully, in line with EU AI Act Article 50.
- **Reasoning Transparency**: auditable reasoning chains and explicit confidence calibration.
- **Human Oversight**: outputs serve as decision support, not autonomous decisions; critical recommendations require human review.
- **Privacy Protection**: full GDPR compliance, data minimization, and ZeroTrust security aligned with German data-sovereignty requirements.
- **Bias Mitigation**: multi-perspective analysis and systematic bias assessment across domains.
- **Environmental Impact**: European deployment with a renewable-energy focus and efficient MoE parameter activation.
## πŸ“„ License
This repository and the model weights are licensed under the MIT License.
- **Open Source**: MIT for development and non-commercial use.
- **Enterprise License**: commercial license available for production deployments β€” [licensing@wemake.cx](mailto:licensing@wemake.cx).
_LSTR is part of the Clarity ecosystem β€” the operating system for organizational intelligence. Built with_ _by Florentin One for the German enterprise market._