Build document-aware AI applications with the TX Text Control AI and MCP NuGet packages. This repository contains application source only: the reusable libraries and document engine are consumed as packages. No private library repository, signing key, or package-building step is required.
| Sample | What you can build | Runs on |
|---|---|---|
| LocalChat | Minimal prompt/response loop | Windows, Linux, macOS with compatible inference runtime |
| LocalStreaming | Streaming output | Same |
| LocalStructuredOutput | Typed JSON extraction | Same |
| LocalToolCalling | Call application functions | Same |
| McpChat | Console document assistant using remote MCP | Same; MCP on Windows/Linux |
| MinimalWeb | Small custom browser UI using the JavaScript client | Same; MCP on Windows/Linux |
| WebDocumentAssistant | Full TXTextControl.AI.Web application: Chat, Document Studio, Runtime, Knowledge and exports | Windows/Linux; native AI can be on another host |
| AiService | Independently hosted AI, runtime administration and Knowledge | Windows, Linux, macOS with compatible inference runtime |
| MinimalMcpHost | Minimal document-engine MCP host | Windows/Linux |
| McpServer | Full MCP host with its own admin pages and style settings | Windows/Linux |
This revision uses the beta.2 AI integration packages and beta.1 MCP server. See beta.2 release and upgrade notes for OpenAI profiles, reasoning/tool compatibility and package availability requirements.
- Install a stable .NET 10 SDK to build the collection. Install the .NET 8 / ASP.NET Core 8 runtimes to run AI samples; MCP targets .NET 10. SDK 8 includes the required .NET 8 runtimes.
- Review the license, TX Text Control licensing requirements and third-party notices.
- Follow getting started. Supply your own licensed GGUF model and compatible inference runtime. Model weights and runtimes are not included or downloaded by NuGet restore.
- Choose a sample above. Every project uses normal NuGet references with versions in Directory.Packages.props.
dotnet restore TXTextControl.AI.Samples.sln
dotnet build TXTextControl.AI.Samples.sln -c Release --no-restoreThe full application keeps its original TXTextControl.AI.Web.csproj, assembly, pages, branding, editor integration and all feature panels. Only its location and package references change. Reusable client.js and editor.js come from TXTextControl.AI.AspNetCore, not copied library JavaScript.
- Local development: full web sample with local inference plus a separate local MCP host.
- Remote inference: web sample proxies to AiService over an authenticated connection; models, runtimes and Knowledge reside on the AI host.
- Apple Silicon: native AI with Linux web/MCP containers.
- Other deployments: Docker build instructions and security guidance.
Minimal samples deliberately restrict unauthenticated traffic to local development. Do not expose them publicly by changing a listening URL. The full samples provide private single-user deployment helpers, not a production multi-tenant identity system.
- Architecture
- Models and runtimes
- Remote AI service
- Knowledge and embeddings
- Browser / Document Editor SDK
- Complete package API guides
- Release checks
No models, native runtime downloads, secrets, private databases or generated documents belong in Git. Sample RTF files contain illustrative data only. See SECURITY.md for responsible reporting and Text Control support for product help.