First public release of MSXCODE, an AI assistant client for MSX computers.
MSXCODE runs on MSX-DOS 2 systems with MSX2-class hardware and connects to OpenAI-compatible chat completion APIs through TCP/IP UNAPI. It provides an 85-column graphical text interface designed for use on real MSX hardware as well as compatible FPGA systems and emulators.
Highlights
- OpenAI-compatible
/v1/chat/completionsAPI client - HTTP and HTTPS support through compatible TCP/IP UNAPI implementations
- Optional bearer-token authentication
- Multi-turn conversation history stored in memory mapper segments
- Function calling with read-only MSX tools:
- Directory listing
- Text and binary file reading
- System date and time
- Basic machine and MSX-DOS information
- Conversation export to disk
- Screen 7 interface powered by
msx2ansi - UTF-8 response conversion for the MSX character set
- Included
MSXCODE.HLPuser help file for MSX-DOSHELP
Requirements
- MSX2, MSX2+, MSX turbo R, or compatible MSX FPGA core
- MSX-DOS 2.x or later
- V9938 or V9958 VDP
- Memory mapper
- TCP/IP UNAPI implementation with TCP and DNS support
HTTPS endpoints require TCP/IP UNAPI 1.1 with TLS support.
Quick Start
Copy MSXCODE.COM and MSXCODE.INI to the same MSX-DOS directory, then edit the configuration:
API_URL=http://api.example.com/v1
API_KEY=your-api-key
LLM_MODEL=your-model-name