cgg 0.4.9
cgg is a short form of call gguf model/file; cgg is a cmd-based app built on gguf-connector, which allows users interacting with large language model (i.e., chatgpt) via a simple command without coding a long long syntax

### GGUF caller

[<img src="https://raw.githubusercontent.com/calcuis/cgg/master/cgg.gif" width="128" height="128">](https://github.com/calcuis/cgg)
[![Static Badge](https://img.shields.io/badge/cgg-release-blue?logo=github)](https://github.com/calcuis/cgg/releases)

This package is a GGUF (GPT-Generated Unified Format) file/model caller. Perfect to run in low end device(s).
#### install the caller via pip/pip3 (once only):
```
pip install cgg
```
If your c/c++ compiler cannot build the engine wheel successfully; could opt to get it [here](https://github.com/abetlen/llama-cpp-python/releases) straight; or try [core](https://pypi.org/project/gguf-core).
#### update the caller (if not in the latest version) by:
```
pip install cgg --upgrade
```
### user manual
This is a cmd-based (command line) package, you can find the user manual by adding the flag -h or --help.
```
cgg -h
```
#### check current version
```
cgg -v
```
#### connector menu
```
cgg menu
```
### graphical user interface (GUI) caller
Simple GUI to interact with a chat model for generating responses (recommended).
#### call cpp connector:
```
cgg cpp
``` 
#### call c connector:
```
cgg c
```
### command line interface (CLI) caller
CLI input also provided for expert/advanced user(s).
#### call gpp connector:
```
cgg gpp
```
#### call g connector:
```
cgg g
```
#### call v connector:
```
cgg v
```

GGUF file(s) in the same directory will automatically be detected by the caller, hence, a selection menu will be shown in the console as below.

[<img src="https://raw.githubusercontent.com/calcuis/chatgpt-model-selector/master/demo.gif" width="350" height="280">](https://github.com/calcuis/chatgpt-model-selector/blob/main/demo.gif)
[<img src="https://raw.githubusercontent.com/calcuis/chatgpt-model-selector/master/demo1.gif" width="350" height="280">](https://github.com/calcuis/chatgpt-model-selector/blob/main/demo1.gif)

#### metadata reader:
You can check model metadata by:
```
cgg r
```
Or try the model analyzor by:
```
cgg a
```
#### divider:
Divide selected model into different part(s) by:
```
cgg d
```
#### merger:
Merge all gguf in the current directory by:
```
cgg m
```
### clone feature
```
cgg clone [url]
```
With this fast clone feature, you can clone any (GGUF model) file from URL, save it automatically in the current directory, and get it ready to connect locally (run it with your own machine offline); depends on the file size, as well as the network connectivity, it may take a while to complete the clone process; and you are able to see a dynamic progress bar showing the downloading status.

If you are a mac newbie, you might encounter ssl cert. issue while executing clone command or while entering the lazylist below; a practical solution: click Install Certificates.command under your Python version folder; details please refer to the [issues](https://github.com/calcuis/cgg/issues/1) reported.

#### sample model(s) available to download (try out)
For general purpose
[chat.gguf] (size: around 2GB or less)
```
cgg clone https://huggingface.co/calcuis/chat/resolve/main/chat.gguf
```
For coding assistance
[code.gguf] (size: around 3GB or more)
```
cgg clone https://huggingface.co/calcuis/code_mini/resolve/main/code.gguf
```
For health/medical advice
[medi.gguf] (size: around 3GB or more)
```
cgg clone https://huggingface.co/calcuis/medi_mini/resolve/main/medi.gguf
```
For law/legal opinion
[law.gguf] (size: around 3GB or more)
```
cgg clone https://huggingface.co/calcuis/law_mini/resolve/main/law.gguf
```
For wealth/financial plan
[finance.gguf] (size: around 3GB or more)
```
cgg clone https://huggingface.co/calcuis/gguf/resolve/main/finance.gguf
```
For calculation/math solution
[math.gguf] (size: around 3GB or more)
```
cgg clone https://huggingface.co/calcuis/gguf/resolve/main/math.gguf
```
***those are all experimental models; no guarantee on quality

#### sample model list
You can either use the clone feature above or opt it straight from the lazy list by:
```
cgg s
```
[<img src="https://raw.githubusercontent.com/calcuis/gguf-connector/master/demo2.gif" width="350" height="225">](https://github.com/calcuis/gguf-connector/blob/main/demo2.gif)

#### gguf pack
Download [gguf](https://github.com/calcuis/gguf-pack) windows portable pack by:
```
cgg p
```
#### comfy gguf pack
Download [comfy](https://github.com/calcuis/comfy) GGUF windows portable pack by:
```
cgg y
```
#### gguf node
Download [node](https://github.com/calcuis/gguf) for comfyui by:
```
cgg n
```
#### prompt generator
Generate random bulk prompt(s) and save it in separate text file(s) by:
```
cgg pg
```
*0.001% duplicate rate approximately; opt to use [cleansor](https://pypi.org/project/cleansor) to remove it*
#### pdf analyzor (beta)
You can load PDF into the model for analysis right away by (analyzor c):
```
cgg pc
```
Or by (analyzor p):
```
cgg pp
```
#### voice/speech recognizor (beta)
You can prompt voice/speech (wav file) as input by (recognizor c):
```
cgg vc
```
Or by (recognizor p):
```
cgg vp
```
Or by (online recognizor c):
```
cgg oc
```
Or by (online recognizor p):
```
cgg op
```
#### image/video generator (beta)
Generate image from text input (t2i) by:
```
cgg t2i
```
Generate video from text input (t2v) by:
```
cgg t2v
```
Generate video from image and/or text input (i2v) by:
```
cgg i2v
```
#### image/video/audio connector
Flux model connector
```
cgg flux
```
Qwen image connector
```
cgg qwen
```
Image edit connector
```
cgg edit
```
Wan video connector
```
cgg wan
```
Ltxv model connector
```
cgg ltxv
```
Mochi connector
```
cgg mochi
```
Docling connector
```
cgg docling
```
Fastvlm connector
```
cgg fastvlm
```
Vibevoice connector
```
cgg vibevoice
```
Gudio connector
```
cgg gudio
```
#### website
Click [gguf.org](https://gguf.org) (mirror of gguf.us) or launch it straight from console by:
```
cgg org
```
Click [gguf.io](https://gguf.io) (mirror of gguf.us) or launch it straight from console by:
```
cgg io
```
Click [gguf.us](https://gguf.us) or launch it straight from console by:
```
cgg us
```