Skip to content

Releases: nataliapc/msxcode

Release list

v0.9.5

Choose a tag to compare

@nataliapc nataliapc released this 11 Jul 10:58

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/completions API 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.HLP user help file for MSX-DOS HELP

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