Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

logo

Langfun

PyPI version codecov pytest

Installation | Getting started | Tutorial | Discord community

Introduction

Langfun is a PyGlove powered library that aims to make language models (LM) fun to work with. Its central principle is to enable seamless integration between natural language and programming by treating language as functions. Through the introduction of Object-Oriented Prompting, Langfun empowers users to prompt LLMs using objects and types, offering enhanced control and simplifying agent development.

To unlock the magic of Langfun, you can start with Langfun 101. Notably, Langfun is compatible with popular LLMs such as Gemini, GPT, Claude, all without the need for additional fine-tuning.

Why Langfun?

Langfun is powerful and scalable:

  • Seamless integration between natural language and computer programs.
  • Modular prompts, which allows a natural blend of texts and modalities;
  • Efficient for both request-based workflows and batch jobs;
  • A powerful eval framework that thrives dimension explosions.

Langfun is simple and elegant:

  • An intuitive programming model, graspable in 5 minutes;
  • Plug-and-play into any Python codebase, making an immediate difference;
  • Comprehensive LLMs under a unified API: Gemini, GPT, Claude, Llama3, and more.
  • Designed for agile developement: offering intellisense, easy debugging, with minimal overhead;

Hello, Langfun

import langfun as lf
import pyglove as pg

from IPython import display

class Item(pg.Object):
  name: str
  color: str

class ImageDescription(pg.Object):
  items: list[Item]

image = lf.Image.from_uri('https://upload.wikimedia.org/wikipedia/commons/thumb/8/83/Solar_system.jpg/1646px-Solar_system.jpg')
display.display(image)

desc = lf.query(
    'Describe objects in {{my_image}} from top to bottom.',
    ImageDescription,
    lm=lf.llms.Gpt4o(api_key='<your-openai-api-key>'),
    my_image=image,
)
print(desc)

Output:

my_image

ImageDescription(
  items = [
    0 : Item(
      name = 'Mercury',
      color = 'Gray'
    ),
    1 : Item(
      name = 'Venus',
      color = 'Yellow'
    ),
    2 : Item(
      name = 'Earth',
      color = 'Blue and white'
    ),
    3 : Item(
      name = 'Moon',
      color = 'Gray'
    ),
    4 : Item(
      name = 'Mars',
      color = 'Red'
    ),
    5 : Item(
      name = 'Jupiter',
      color = 'Brown and white'
    ),
    6 : Item(
      name = 'Saturn',
      color = 'Yellowish-brown with rings'
    ),
    7 : Item(
      name = 'Uranus',
      color = 'Light blue'
    ),
    8 : Item(
      name = 'Neptune',
      color = 'Dark blue'
    )
  ]
)

See Langfun 101 for more examples.

Install

Langfun offers a range of features through Extras, allowing users to install only what they need. The minimal installation of Langfun requires only PyGlove, Jinja2, and requests. To install Langfun with its minimal dependencies, use:

pip install langfun

For a complete installation with all dependencies, use:

pip install langfun[all]

To install a nightly build, include the --pre flag, like this:

pip install langfun[all] --pre

If you want to customize your installation, you can select specific features using package names like langfun[X1, X2, ..., Xn], where Xi corresponds to a tag from the list below:

Tag Description
all All Langfun features.
vertexai VertexAI access.
mime All MIME supports.
mime-pil Image support for PIL.
ui UI enhancements

For example, to install a nightly build that includes VertexAI access, full modality support, and UI enhancements, use:

pip install langfun[vertexai,mime,ui] --pre

Disclaimer: this is not an officially supported Google product.

Download files

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

Source Distribution

langfun-0.1.2.dev202607270906.tar.gz (447.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

langfun-0.1.2.dev202607270906-py3-none-any.whl (617.4 kB view details)

Uploaded Python 3

File details

Details for the file langfun-0.1.2.dev202607270906.tar.gz.

File metadata

  • Download URL: langfun-0.1.2.dev202607270906.tar.gz
  • Upload date:
  • Size: 447.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for langfun-0.1.2.dev202607270906.tar.gz
Algorithm Hash digest
SHA256 0f449c03b8d15a30e72b3d3e7f85e1407f1600ff21b29a2bc8ab867c6ddae0ec
MD5 69f4bb3248e67fd59452abd91d5bb9c7
BLAKE2b-256 46226fb49b7c2d457324e865f1eaa4a26ebcf3779b52ec673d3947656d991c9d

See more details on using hashes here.

File details

Details for the file langfun-0.1.2.dev202607270906-py3-none-any.whl.

File metadata

File hashes

Hashes for langfun-0.1.2.dev202607270906-py3-none-any.whl
Algorithm Hash digest
SHA256 5de67b0368bfb50b7a6681442c93f3466739015804d99be9325a17a96c45ebdd
MD5 8ccb6e81bcbfd4c547a07ef8dae628a9
BLAKE2b-256 0e8af3b0b3505f85dc02f65a5d329c266979a31938ce5ef98be8cc94a101d4ac

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page