Skip to main content

Python bindings for @ggerganov's llama.cpp

Project description

Python bindings for llama.cpp

Building the Python bindings

macOS

brew install pybind11  # Installs dependency
git submodule init && git submodule update
poetry install

From PyPI

pip install llamacpp

Get the model weights

You will need to obtain the weights for LLaMA yourself. There are a few torrents floating around as well as some huggingface repositories (e.g https://huggingface.co/nyanko7/LLaMA-7B/). Once you have them, copy them into the models folder.

ls ./models
65B 30B 13B 7B tokenizer_checklist.chk tokenizer.model

Convert the weights to GGML format using llamacpp-convert. Then use llamacpp-quantize to quantize them into INT4. For example, for the 7B parameter model, run

llamacpp-convert ./models/7B/ 1
llamacpp-quantize ./models/7B/
llamacpp-cli

Note that running llamacpp-convert requires torch, sentencepiece and numpy to be installed. These packages are not installed by default when your install llamacpp.

Command line interface

The package installs the command line entry point llamacpp-cli that points to llamacpp/cli.py and should provide about the same functionality as the main program in the original C++ repository. There is also an experimental llamacpp-chat that is supposed to bring up a chat interface but this is not working correctly yet.

Demo script

See llamacpp/cli.py for a detailed example. The simplest demo would be something like the following:

params = llamacpp.gpt_params(
	'./models/7B/ggml_model_q4_0.bin', # model,
	"A llama is a ", # prompt
	"", # reverse_prompt
	512, # ctx_size
	100, # n_predict
	40, # top_k
	0.95, # top_p
	0.85, # temp
	1.30, # repeat_penalty
	-1, # seed
	8, # threads
	64, # repeat_last_n
	8, # batch_size
	False, # color
	False, # interactive or args.interactive_start
	False, # interactive_start
)
model = llamacpp.PyLLAMA(params)
model.add_bos()		# Adds "beginning of string" token
model.update_input(params.prompt)
model.print_startup_stats()
model.prepare_context()

model.ingest_all_pending_input(True)
while not model.is_finished():
	model.ingest_all_pending_input(not input_noecho)
	text, is_finished = model.infer_text()
	print(text, end="")
if is_finished:
	break

ToDo

  • Use poetry to build package
  • Add command line entry point for quantize script
  • Publish wheel to PyPI
  • Add chat interface based on tinygrad

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

llamacpp-0.1.6.tar.gz (8.6 kB view hashes)

Uploaded Source

Built Distributions

llamacpp-0.1.6-cp311-cp311-win_amd64.whl (183.5 kB view hashes)

Uploaded CPython 3.11 Windows x86-64

llamacpp-0.1.6-cp311-cp311-musllinux_1_1_x86_64.whl (801.4 kB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ x86-64

llamacpp-0.1.6-cp311-cp311-musllinux_1_1_aarch64.whl (771.1 kB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ ARM64

llamacpp-0.1.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (284.1 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

llamacpp-0.1.6-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (268.0 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARM64

llamacpp-0.1.6-cp311-cp311-macosx_12_0_x86_64.whl (235.5 kB view hashes)

Uploaded CPython 3.11 macOS 12.0+ x86-64

llamacpp-0.1.6-cp310-cp310-win_amd64.whl (183.5 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

llamacpp-0.1.6-cp310-cp310-musllinux_1_1_x86_64.whl (801.4 kB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ x86-64

llamacpp-0.1.6-cp310-cp310-musllinux_1_1_aarch64.whl (771.2 kB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ ARM64

llamacpp-0.1.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (284.1 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

llamacpp-0.1.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (268.0 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64

llamacpp-0.1.6-cp310-cp310-macosx_13_0_arm64.whl (207.9 kB view hashes)

Uploaded CPython 3.10 macOS 13.0+ ARM64

llamacpp-0.1.6-cp310-cp310-macosx_12_0_x86_64.whl (235.5 kB view hashes)

Uploaded CPython 3.10 macOS 12.0+ x86-64

llamacpp-0.1.6-cp39-cp39-win_amd64.whl (183.5 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

llamacpp-0.1.6-cp39-cp39-musllinux_1_1_x86_64.whl (801.4 kB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ x86-64

llamacpp-0.1.6-cp39-cp39-musllinux_1_1_aarch64.whl (771.5 kB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ ARM64

llamacpp-0.1.6-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (284.1 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

llamacpp-0.1.6-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (268.1 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARM64

llamacpp-0.1.6-cp39-cp39-macosx_12_0_x86_64.whl (235.5 kB view hashes)

Uploaded CPython 3.9 macOS 12.0+ x86-64

llamacpp-0.1.6-cp38-cp38-musllinux_1_1_aarch64.whl (771.3 kB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ ARM64

llamacpp-0.1.6-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (268.1 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARM64

llamacpp-0.1.6-cp37-cp37m-musllinux_1_1_aarch64.whl (773.7 kB view hashes)

Uploaded CPython 3.7m musllinux: musl 1.1+ ARM64

llamacpp-0.1.6-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (270.9 kB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ ARM64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page