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-1.0.0.tar.gz (38.5 kB view details)

Uploaded Source

Built Distribution

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

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for ai4burmese-1.0.0.tar.gz
Algorithm Hash digest
SHA256 e78e0f1318479ac2b27a6e62891e1a6d080b4e0d4c579f608e2818f7267f8a0e
MD5 df5695834ca65462d8c71b8ec1a1d145
BLAKE2b-256 fdae09f1e9f1671651939e837cadd2cfebee0160b80e42f104dc919e73bcb4b3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ai4burmese-1.0.0-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-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14ddf9ca635518a348dc12d155b9b46b28dd4b6d82a19195fb8065b2a5fe5075
MD5 95d447ac1b93f1e22552847548a2d8b0
BLAKE2b-256 f4e2c65da535f07f2c75f8495c0c02d28610539e6e51e05c359f5b5808c6eddd

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