A powerful and intuitive terminal utility for interacting with both local and cloud LLMs.
A tool for those who appreciate keyboard driven apps and terminal workflows
Features
- 📦 Single binary - lightweight, zero dependencies, use anywhere without any requirements
- 🤖 Support for OpenAI compatible APIs (ChatGPT, Mistral, Ollama, LMStudio, and more)
- 🌟 Support for Gemini API
- 💬 Chat sessions management and quick chats
- ⚙️ Settings presets (configure different personas with unique settings)
- ✂️ Convenient text selection tool (vim-like line selection)
- 🌐 Crossplatform - support for MacOS, Windows and Linux
- 🎨 Multiple themes
README
NEKOT
A powerful and intuitive terminal utility for interacting with both local and cloud LLMs.
A tool for those who appreciate keyboard driven apps and terminal workflows
Features
📦 Single binary - lightweight, zero dependencies, use anywhere without any requirements
🤖 Support for OpenAI compatible APIs (ChatGPT, Mistral, Ollama, LMStudio, and more)
🌟 Support for Gemini API
💬 Chat sessions management and quick chats
⚙️ Settings presets (configure different personas with unique settings)
✂️ Convenient text selection tool (vim-like line selection)
🌐 Crossplatform - support for MacOS, Windows and Linux
🎨 Multiple themes
Demo
App installation
Ensure API keys are set before proceeding to installtion
Homebrew (MacOS, Linux)
brew tap BalanceBalls/BalanceBalls
brew install nekot --cask
Chocolatey (Windows)
choco install nekot
Shell script (Linux, MacOS)
Requires curl and tar.
For updating the app, just run the script again
Basic install:
Requires sudo, and installs to /usr/local/bin/
curl -fsSL https://raw.githubusercontent.com/BalanceBalls/nekot/main/install.sh | sudo sh
Install to path:
Use -p flag to specify install path.
Make sure the specified directory is in the $PATH.
export GEMINI_API_KEY="some-key" # you would want to export this in your .zshrc or .bashrc
Config
We provide a config.json file within your directory for easy access to essential settings.
On MacOS & Linux, the path is ~/.nekot/config.json.
On Windows, the path is C:\Users\%UserName%\.nekot\config.json or %HOMEPATH%\.nekot\config.json
Example
{
"providerBaseUrl": "https://api.openai.com", // Or http://localhost:1143, or any other OpenAi compatible API
"systemMessage": "",
"defaultModel": "",
"colorScheme": "groove", // pink, blue, groove
"provider": "openai" // openai, gemini
}
providerBaseUrl: The url can be anything that follows OpenAI API standard ( ollama, lmstudio, etc)
chatGPTApiUrl [obsolete]: same as providerBaseUrl
systemMessage field is available for customizing system prompt messages. Better to set it from the app
defaultModel field sets the default model. Better to set it from the app
Providers
You can change API provider using the provider field.
Available providers:
openaidefault
gemini
To use GeminiAPI, just set "provider": "gemini" (make sure to set GEMINI_API_KEY env variable).
When using the gemini provider, providerBaseUrl param is not used.
Themes
You can change colorscheme using the colorScheme field.
Available themes:
groovedefault
pink
blue
Data migration
If you need your settings and chats on other machine - simply copy chat.db and config.json from the .nekot/ directory
and paste to the same directory on other machine.
Flags
Cache invalidation
Models list is cached for 14 days upon loading. If you need to invalidate cache use --purge-cache flag:
nekot --purge-cache
Provider
To switch between openai and gemini APIs you can use -p flag:
nekot -p openai
nekot -p gemini
Provider url
To specify provier url use -u flag(works with the openai provider only):
nekot -u http://localhost:11434
Theme
To specify color scheme use -t flag:
nekot -t blue
Global Keybindings
Tab: Change focus between panes. The currently focused pane will be highlighted
