FEW DOS Cli v1.0 - Few Little Tools DOS Client
==============================================
2026-04-06
https://few.lt/

A DOS command-line client for few.lt - a free, open, no-tracking
utility tool site. FOSS, transparent, no ads.

Access AI text tools, hashing, link tools and many more directly
from real DOS over a plain HTTP connection.


REQUIREMENTS
------------
  - 386 or better CPU (486DX2 recommended)
  - DOS 3.3 or later (MS-DOS, FreeDOS, DR-DOS)
  - A packet driver loaded for your network card
  - TCP/IP network access


FILES
-----
  FEW.EXE      - Main executable
  FEW.INI      - Configuration file
  CWSDPMI.EXE  - DPMI host (required, auto-loaded by FEW.EXE)
  README.TXT   - This file.


ADDITIONAL FILES
-----
  DOSBXCFG.TXT - DOSBox-X configuration guide
  FILE_ID.DIZ  - BBS-style entry
  FILES.BBS    - quill.lt-compatible archive entry
  NE2000.COM   - DOSBox-X-compatible packet driver
  WATTCP.CFG   - Watt-32 TCP/IP library network configuration
                 (preconfigured for DOSBox-X)
  EUPL12EN.TXT - European Union Public Licence v1.2 (EUPL v1.2)
                 English text
  FEW.IMA      - 1.44MB floppy disk image (FAT12)
  SRC/         - source file and build scripts
  PHPPROXY/    - PHP script allowing to relay requests to https
                 website and converting UTF-8 to appropriate CP

SETUP
-----
1. Load your NIC's packet driver before running FEW.EXE.
   Example in AUTOEXEC.BAT:

     3C509.COM 0x60

2. Edit FEW.INI if needed (defaults point to dos.few.lt):

     [few]
     host=dos.few.lt      ; server hostname or IP
     port=80              ; server port
     lang=en-GB           ; response language (e.g. lt-LT, de-DE)
     login=               ; few.lt account login (optional)
     password=            ; few.lt account password (optional)
     translit=0           ; 1 = transliterate non-ASCII to nearest
                          ;     Latin equivalent (useful if your
                          ;     terminal/codepage does not support
                          ;     the target language characters)
                          ; 0 = convert to appropriate DOS codepage

3. Run FEW.EXE from the directory containing all three files.


USAGE
-----
  few <cmd> [options] [text]

  List of commands:
    few help

  Detailed description of a command:
    few help <command>

  Override INI values for a single run:
    few ai --summarize --lang lt-LT Some text here
    few ai --ask --login myuser --password mypass Question

  Pipe input:
    type essay.txt | few ai --summarize
    type file.txt  | few hash --sha256
    few ai --summarize < file_id.diz
    few hash --sha256  < readme.txt

  With context (stdin as context, arg as question):
    type readme.txt | few ai --ask "how to configure this driver?"
    type config.sys | few ai --ask "why my soundblaster isn't working?"


NETWORKING
----------
  FEW.EXE uses the Watt-32 TCP/IP stack and communicates directly
  through a packet driver. No DOS networking stack is required.
  DHCP is used automatically if no static IP is configured.


BUILDING FROM SOURCE
--------------------
  On DOS with DJGPP + Watt-32:
    BUILD.BAT

  On Linux (cross-compile):
    make DJGPP_PREFIX=/path/to/djgpp WATT_ROOT=/path/to/watt32

  Full toolchain setup on Linux:
    bash setup-toolchain.sh

  Source code is bundled with the archive.


LICENSE
-------
  Copyright (C) Konstantinas F. Pacevičius, few.lt, ineptwizard.com
  Licensed under the European Union Public Licence v1.2 (EUPL v1.2)
  https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12


ACKNOWLEDGEMENTS
----------------
  DJGPP (compiler and C runtime)
    Copyright (C) DJ Delorie and contributors.
    GCC portions licensed under GNU GPL v2+; DJGPP runtime under a
    modified licence permitting static linking. https://www.delorie.com/djgpp/

  Watt-32 TCP/IP library
    Copyright (C) 1997-2007 Gisle Vanem <gvanem@yahoo.no>
    BSD-style permissive licence. Source: https://github.com/gvanem/Watt-32

  CWSDPMI (DPMI host)
    Copyright (C) 1995-2008 Charles W. Sandmann
    Licensed under GNU GPL v2.
    Source: http://homer.rice.edu/~sandmann/cwsdpmi/

  NE2000.COM (packet driver, included for DOSBox-X users)
    Packet driver skeleton copyright 1988-93, Crynwr Software.
    Licensed under GNU General Public Licence v1, February 1989.
    This program is freely copyable; source must be available; NO WARRANTY.
    Source: http://crynwr.com/drivers/many-other-drivers.zip
