Metadata-Version: 2.1
Name: gubbi
Version: 1.0.2
Summary: Minimalist terminal LLM chatbot
Home-page: https://github.com/prahladyeri/gubbi
Author: Prahlad Yeri
Author-email: prahladyeri@yahoo.com
License: MIT
Project-URL: Homepage, https://github.com/prahladyeri/gubbi
Project-URL: Repository, https://github.com/prahladyeri/gubbi
Project-URL: Issues, https://github.com/prahladyeri/gubbi/issues
Description: ![python](https://img.shields.io/pypi/pyversions/gubbi.svg)
        ![license](https://img.shields.io/github/license/prahladyeri/gubbi.svg)
        [![paypal](https://img.shields.io/badge/PayPal-blue.svg?logo=paypal)](https://paypal.me/prahladyeri)
        [![follow](https://img.shields.io/twitter/follow/prahladyeri.svg?style=social)](https://x.com/prahladyeri)
        
        # gubbi
        
        A minimal, chat-native LLM client for people who work in terminals and want explicit control over file attachments, session files, and provider switching without learning a plugin system.
        
        # Installation
        
        	pip install gubbi
        	
        # Configuration
        
        All configuration is stored in `~/.config/gubbi/settings.json`. At least one provider needs added in order for chat to work. Either add it manually or program will ask for inputs on the first start.
        
        ```json
        {
            "providers": {
                "github": {
                    "slug": "github",
                    "url": "https://models.github.ai/inference",
                    "default_model_id": "openai/gpt-4.1-mini"
                }
            }
        }
        ```
        
        In theory, it should work with any provider who follows [openai api spec](https://developers.openai.com/api/) though I've only tested with github and few others so far. Let me know through issue tracker if it works for others.
        	
        # Usage
        
        ```bash
        usage: gubbi [-h] [-a] [-v]
        
        Gubbi chat interface
        
        optional arguments:
          -h, --help          show this help message and exit
          -a, --add-provider  Add OpenAI compatible provider
          -v, --version       show program's version number and exit
        ```
        	
        # Commands
        
        When a message starts with / (slash), it is interpreted as special command rather than a chat message sent to the LLM.
        
        ```plaintext
        /help => List commands
        /exit => Quit chat
        /use <provider> => Switch provider
        /model <model_name> => Switch model
        /attach <path> => Attach a file
        /clear => Clear context
        /save => Save current chat
        /load <filename> => Load an earlier chat
        /models <filename> => List all models
        /providers <filename> => List all providers	
        ```
        
        # Screenshot
        
        ![gubbi-chatbot](assets/screenshot.png)
Keywords: llm,chatbot,terminal
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
