Skip to main content

AI4Burmese is an open Burmese-first AI ecosystem package, including Padauk and local GGUF releases for practical tool use, function calling, and accessible deployment.

Project description

AI4Burmese

AI4Burmese is an open Burmese-first AI ecosystem created by Dr. Wai Yan Nyein Naing. This Python package is the main package for AI4Burmese projects, including Padauk, a practical agentic small language model built for Burmese language understanding, tool use, function calling, and local or edge deployment.

Mission

AI4Burmese exists to help ensure Myanmar is not left behind in the age of AI.

The mission is to make AI more open, free, accessible, and useful for Burmese-speaking communities across different backgrounds, including users, students, builders, researchers, and developers.

AI4Burmese supports practical open-source AI that people can use, study, build on top of, and adapt for real local needs.

Why AI4Burmese

Burmese remains a low-resource language in AI, and practical Burmese AI tooling is still limited for many real developer and end-user workflows.

AI4Burmese focuses on useful, production-minded, and developer-friendly Burmese AI systems that are:

  • open for learning and contribution
  • free and accessible for broader use
  • practical for real workflows
  • buildable so others can extend them
  • designed for Burmese-first interaction with English support

The goal is not only to release models, but also to make Burmese AI easier to use, easier to deploy, and easier to build on.

Included Ecosystem Direction

AI4Burmese is the umbrella initiative. Model families and releases can include:

  • Padauk — Burmese-first agentic assistant model
  • Padauk GGUF — quantized local deployment release
  • Burmese-Coder — Burmese technical and coding model direction
  • future open-source Burmese AI tools and runtimes

Current Model Repositories

  • Source adapter model: WYNN747/ai4burmese-padauk
  • GGUF local model: WYNN747/ai4burmese-padauk-gguf

End-User Install And Use

This section is the simple user flow only: install, download, run, and test the local API.

Requirements:

  • Python >=3.10
  • a working llama-server binary
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "ai4burmese[full]"

If your default python3 is below 3.10, use an explicit interpreter:

/opt/homebrew/bin/python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "ai4burmese[full]"

Download Model And Run API

export AI4BURMESE_LLAMA_SERVER="$HOME/llama.cpp/build/bin/llama-server"
ai4burmese download --quant q8_0
ai4burmese serve --quant q8_0 --backend auto --host 127.0.0.1 --port 8000

Keep that terminal running while you test requests.

Test With API Call

curl http://127.0.0.1:8000/v1/models
curl http://127.0.0.1:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-no-key-required" \
  -d '{
    "model": "padauk-agent",
    "messages": [{"role": "user", "content": "မင်္ဂလာပါ"}]
  }'

Test With OpenAI Agents SDK

python -m pip install openai-agents
import asyncio

from openai import AsyncOpenAI
from agents import Agent, Runner, set_default_openai_api, set_default_openai_client, set_tracing_disabled

set_tracing_disabled(True)
set_default_openai_api("chat_completions")
set_default_openai_client(
    AsyncOpenAI(base_url="http://127.0.0.1:8000/v1", api_key="sk-no-key-required")
)

padauk = Agent(
    name="Padauk Assistant",
    model="padauk-agent",
    instructions="Reply in Burmese by default.",
)

async def main() -> None:
    result = await Runner.run(padauk, input="မင်္ဂလာပါ")
    print(result.final_output)

asyncio.run(main())

What This Package Is For

AI4Burmese is intended for:

  • Burmese-first assistant applications
  • local and self-hosted Burmese AI workflows
  • tool-calling and function-calling assistants
  • MCP-connected and skill-based systems
  • practical Burmese AI experimentation
  • community-accessible open AI infrastructure

Maintainer Release Validation

If you are packaging or rebuilding the model, use maintainer-facing documentation such as:

  • release guide
  • Hugging Face to GGUF conversion guide
  • runtime compatibility notes for Gemma 4 / llama.cpp

Links

License

This package may include integrations and packaging around models released under their respective upstream licenses. Model usage remains subject to the base model license and any repository-specific release notes.

Citation

If you use AI4Burmese or Padauk in research or product work, please cite the project and model pages.

@misc{ai4burmese2026,
  title = {AI4Burmese: Open Burmese-First AI Ecosystem},
  author = {Wai Yan Nyein Naing},
  year = {2026},
  url = {https://ai4burmese.com/}
}

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

ai4burmese-0.1.12.tar.gz (38.4 kB view details)

Uploaded Source

Built Distribution

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

ai4burmese-0.1.12-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

Details for the file ai4burmese-0.1.12.tar.gz.

File metadata

  • Download URL: ai4burmese-0.1.12.tar.gz
  • Upload date:
  • Size: 38.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.13

File hashes

Hashes for ai4burmese-0.1.12.tar.gz
Algorithm Hash digest
SHA256 2bbc221007c5debbe6e233233e07a973f0dbb8b3be328d5347ceb6ae43192f53
MD5 24e0e649b72249cbc80832e3e7f1bc71
BLAKE2b-256 f88d80ea5d51b9a9699001393cf119489add9284b611008b5ac82bf6cf43e914

See more details on using hashes here.

File details

Details for the file ai4burmese-0.1.12-py3-none-any.whl.

File metadata

  • Download URL: ai4burmese-0.1.12-py3-none-any.whl
  • Upload date:
  • Size: 22.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.13

File hashes

Hashes for ai4burmese-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 e6446227dc641aada2acd29c2bc5514139f32cab70208d6fec4cf942269a9484
MD5 8d7e18c78452bd28be5ec3f3deb9dfe9
BLAKE2b-256 01648f764b10457b307fb686ae582076e8c6f9c3b18aeb636ad9da898055799f

See more details on using hashes here.

Supported by

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