Skip to content

Latest commit

 

History

History
150 lines (97 loc) · 10.8 KB

README.md

File metadata and controls

150 lines (97 loc) · 10.8 KB

AmigaGPT

AmigaGPT is a text generation program that runs on the classic AmigaOS. Utilising the power of the OpenAI's GPT-3 and GPT-4 architectures, this program brings state-of-the-art language modeling to your Amiga computer.

Screenshot 2023-06-15 at 10 26 38 pm

Features

  • State-of-the-art language model

AmigaGPT uses the GPT-4 architecture developed by OpenAI to generate coherent, context-aware responses to your input.

  • Seamless integration with AmigaOS

AmigaGPT takes full advantage of the latest AmigaOS 3.2 API to provide a smooth, native user experience without the need to have third party frameworks installed.

  • UI customisation

You can customise the look and feel of the application, including the ability to choose the fonts and a choice of opening in the Workbench screen or a custom screen.

  • Speech capability

AmigaGPT can use the Amiga's speech synthesis capability to read the generated text aloud with support for switching between the old Workbench 1.x v34 and the Workbench 2.0 v37 speech synthesisers.

System Requirements

Ensure you have the necessary system requirements:

  • An OCS/ECS/AGA Amiga
  • AmigaOS 3.9 and AmigaOS 3.X included in Amiga Forever supported but AmigaOS 3.2 or higher recommended
  • Motorola 68020 or higher CPU
  • Internet access using a TCP/IP stack such as Roadshow (http://roadshow.apc-tcp.de/index-en.php)
  • AmiSSL 5.9 or higher (http://aminet.net/util/libs/AmiSSL-5.9-OS3.lha)
  • An OpenAI account with an active API key
  • Optional: A copy of the Workbench 1.x disk to install narrator.device v34 and a copy of the Workbench 2.0 disk to install narrator.device v37

Installation

  • Install AmiSSL and a TCP/IP stack if not already done so
  • Download the latest release of AmigaGPT
  • Extract the amigagpt.lha archive to your desired location

Optional steps to enable speech functionality

AmigaGPT supports reading the output aloud. This requires a file called narrator.device which cannot be included with AmigaGPT because it is still under copyright. Therefore, you must copy this file legally from your Workbench disks so that AmigaGPT will be able to synthesise speech. There are 2 versions of narrator.device supported, v34 and v37.

v34 is the original version that came with Workbench 1.x. v37 was an updated version included with Workbench 2.0.x. It has more features and sounds more natural, however it does sound quite different which is why AmigaGPT supports you installing both versions and your choice of version to be used can be selected in the Speech menu in the app.

Regardless of which version of narrator.device you choose to install (or both), AmigaGPT requires that you install the free third party translator.library v43. This works with both versions of narrator.device.

Installing translator.library v43

Since translator.library v43 is not available as a standalone install, you will need to install v42 and then patch it to v43.

  • Download http://aminet.net/util/libs/translator42.lha and extract the archive to any convenient location on your Amiga such as RAM:
  • Navigate to that directory and double click the Install program
  • Run the installer using all the default settings
  • Download http://aminet.net/util/libs/Tran43pch.lha and once again extract it to a location of your choice
  • Navigate to that directory and double click the Install program
  • Run the installer using all the default settings
  • Reboot your Amiga - It will not work until the system is restarted

Installing narrator.device v34

  • Insert your Workbench 1.x disk and copy df0:devs/narrator.device to {AmigaGPTProgramDirectory}/devs/speech/34

Installing narrator.device v37

  • Insert your Workbench 2.0.x (you cannot use 2.1 because the speech libraries were removed after version 2.0.4) disk and copy df0:devs/narrator.device to {AmigaGPTProgramDirectory}/devs/speech/37

Launching AmigaGPT

  • Launch the application by double-clicking the AmigaGPT icon
  • You may also launch the app in the command line but before you do, run the command STACK 20000 to give the program 20kb of stack since the default stack size for apps launched from the shell is 4kb and this is not enough for AmigaGPT and will cause random crashes due to stack overflow. This is not required when you launch the app by double clicking the icon since the stack size is saved in the icon

Usage

When launched, AmigaGPT presents you with a choice of opening the app in a new screen or opening in Workbench. If you open in a new screen you have the ability to create a screen for the app to open in. AmigaGPT supports anything from 320x200 all the way up to 4k resolution if using a video card for RTG. Bear in mind text will appear very tiny in resolutions above 1080p so you may want to increase the font size settings from the View menu when the app opens.

When launching for the first time you will need to enter your OpenAI API key before you can start chatting. If you haven't already done so, create an OpenAI account and navigate to https://platform.openai.com/account/api-keys to generate an API key for use with AmigaGPT.

When the app has opened, you are presented with a text input box. You can type any prompt into this box and press "Send" to see the GPT-4 model's response. The generated text appears in the box above the input. You can choose to have this text read aloud using the "Speech" menu option. You can also select which model for OpenAI to use in the "OpenAI" menu option.

To the left of the chat box is a conversation list which you can use to go to another saved conversation. New conversations can be created with the "New chat" button and conversations can be removed with the "Delete chat" button.

In the "Edit" menu, you'll find basic text editing commands like Cut, Copy, Paste and Clear. The "View" menu allows you to change the font used in the chat and the UI.

The "Project" menu includes an "About" option, which displays information about the program.

Models

GPT-4

GPT-4 is currently in a limited beta and only accessible to those who have been granted access. Please join the waitlist to get access.

GPT-4 is a large multimodal model (accepting text inputs and emitting text outputs today, with image inputs coming in the future) that can solve difficult problems with greater accuracy than any of our previous models, thanks to its broader general knowledge and advanced reasoning capabilities. For many basic tasks, the difference between GPT-4 and GPT-3.5 models is not significant. However, in more complex reasoning situations, GPT-4 is much more capable than any of our previous models.

Model Description Max Tokens Training Data
gpt-4 More capable than any GPT-3.5 model, able to do more complex tasks, and optimized for chat. Will be updated with our latest model iteration 2 weeks after it is released. 8,192 Up to Sep 2021
gpt-4-0613 Snapshot of gpt-4 from June 13th 2023 with function calling data. Unlike gpt-4, this model will not receive updates, and will be deprecated 3 months after a new version is released. 8,192 Up to Sep 2021
gpt-4-32k Same capabilities as the base gpt-4 mode but with 4x the context length. Will be updated with our latest model iteration. 32,768 Up to Sep 2021
gpt-4-32k-0613 Snapshot of gpt-4-32 from June 13th 2023. Unlike gpt-4-32k, this model will not receive updates, and will be deprecated 3 months after a new version is released. 32,768 Up to Sep 2021

GPT-3.5

GPT-3.5 models can understand and generate natural language or code. Our most capable and cost effective model in the GPT-3.5 family is gpt-3.5-turbo which has been optimized for chat but works well for traditional completions tasks as well.

Model Description Max Tokens Training Data
gpt-3.5-turbo Most capable GPT-3.5 model and optimized for chat at 1/10th the cost of text-davinci-003. Will be updated with our latest model iteration 2 weeks after it is released. 4,096 Up to Sep 2021
gpt-3.5-turbo-0613 Snapshot of gpt-3.5-turbo from June 13th 2023 with function calling data. Unlike gpt-3.5-turbo, this model will not receive updates, and will be deprecated 3 months after a new version is released. 4,096 Up to Sep 2021
gpt-3.5-turbo-16k Same capabilities as the standard gpt-3.5-turbo model but with 4 times the context. 16,384 Up to Sep 2021
gpt-3.5-turbo-16k-0613 Snapshot of gpt-3.5-turbo-16k from June 13th 2023. Unlike gpt-3.5-turbo-16k, this model will not receive updates, and will be deprecated 3 months after a new version is released. 16,384 Up to Sep 2021

Developing

You can either compile the code natively or with the Docker container.

Native

Building the AmigaOS 3 app

If you would like to build this project from source you will need Bebbo's amiga-gcc toolchain here https://github.com/bebbo/amiga-gcc

Once installed, get the required other SDK's from https://github.com/sacredbanana/AmigaSDK-gcc and put these in your Amiga dev environment created in the above step.

Building the AmigaOS 4 app

Get this toolchain set up https://github.com/sba1/adtools

Once installed, get the required other SDK's from https://github.com/sacredbanana/AmigaSDK-gcc and put these in your Amiga dev environment created in the above step.

Docker

You may use an all-in-one Docker image that is able to compile both the AmigaOS 3 and AmigaOS 4 versions of the app.

Just install Docker on your machine and run the build_os3.sh or build_os4.sh scripts depending on which version of the app you want to build. If you want to perform a clean build, you can set the environment variable CLEAN=1 for example you can run CLEAN=1 ./build_os3.sh.

The build app will be saved to the /out directory.

License

AmigaGPT is licensed under the MIT License.

Contributing

We welcome contributions to AmigaGPT! If you have a bug to report, a feature to suggest, or a change you'd like to make to the code, please open a new issue or submit a pull request.

Contributors

Code

Art

  • Mauricio Sandoval - Icon design

Special Thanks