https://github.com/kessler/node-assist
a personal AI assistant
https://github.com/kessler/node-assist
ai cli command-line-tool generative-ai gpt gpt-3 gpt-4 llm
Last synced: 22 days ago
JSON representation
a personal AI assistant
- Host: GitHub
- URL: https://github.com/kessler/node-assist
- Owner: kessler
- License: apache-2.0
- Created: 2023-07-01T00:17:44.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-07T20:29:26.000Z (over 1 year ago)
- Last Synced: 2025-04-04T03:31:52.311Z (28 days ago)
- Topics: ai, cli, command-line-tool, generative-ai, gpt, gpt-3, gpt-4, llm
- Language: JavaScript
- Homepage:
- Size: 171 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# @kessler/assist
Personal AI assistant / cli tool for accessing GPT.
## install
You'll need an openai api key.
```
$ npm install -g @kessler/assist
$ kes init
```
## Interactive mode
The simplest usage, like a session in chatgpt.
```
$ kes
send an empty string (hit enter) to exit
[me]: hello
[chatgpt]:
Hello!
```
## Query command
Sends a query and get back the bare response from openai. Process will exit afterwards.
Specify query immediately in the cli:
```
$ kes query hello
Hello!
```
or read from stdin:
```
$ echo 'hello' | kes query
no content provided, waiting for content from stdin... (this is printed on stderr)
Hi
```
## options
These options apply to interactive and query commands
### -a, --actor
Set an actor for this session, See actor command
### -p --preprompt
Prepend some text to the session, especially useful when ingesting content from stdin.
### -t, --temperature
Set the temperature for this session.
### -m, --model
Select a model for this session.
## Embedding commands
add, query and delete embedding.
### add
```
$ kes embedding add mycollection "The little brown fox"
```
### query
```
$ kes e query mycollection "the little dark fox"
[{"similarity":0.9487346256454315,"text":"the little brown fox","metadata":{"created":1691421248707}}]
```
### del
TBD
## Actor commands
Manage actors. Actors will be sent as ```{ "role": "system" }``` before queries or in interactive mode.
An interesting discussion on "role system" [here](https://community.openai.com/t/the-system-role-how-it-influences-the-chat-behavior/87353/2)
Use actors by specifying the `--actor=[actor]` in `kes` or `kes query`
### add
```
$ kes actor add
actor name: darkgpt
actor prompt: ... prompt text here ...
```
### remove
```
$ kes actor remove
Select actor to remove: (Use arrow keys)
❯ - cancel
prompt
dark
```
### list
list all actors, visibility is a little broken right now :-)
## other stuff
### tasks
- implement config commands
- implement history
### resources
- https://github.com/SBoudrias/Inquirer.js
- https://the-decoder.com/chatgpt-guide-prompt-strategies/
- https://prompts.chat/
- https://blog.tryamigo.com/how-to-use-chatgpt-for-coding/