Skip to main content

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.10 -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 (3.11+ example):

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/}
}

Metadata

Release files for ai4burmese 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai4burmese 1.0.1
File Size Uploaded Provenance
ai4burmese-1.0.1.tar.gz 38.5 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ai4burmese 1.0.1
File Interpreter ABI Platform
ai4burmese-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 61.2 kB

Release files / ai4burmese-1.0.1.tar.gz

Download URL ai4burmese-1.0.1.tar.gz
Size 38.5 kB
Tags Source
SHA-256 checksum
How to use checksums
414e4f9842fbcf661c4b0f0e105121da5eedd2536f4c19ba592a450db862b2ed
BLAKE2b-256 checksum
How to use checksums
181f36acfe1637b1df800ba684e4273d90ce35ab43f8be361b9d594867feb897
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 18, 2026.

Transparency log

Release files / ai4burmese-1.0.1-py3-none-any.whl

Download URL ai4burmese-1.0.1-py3-none-any.whl
Size 22.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bad7f317d397dd885fadca530d8bd4ed324c36489322101d0bfba04bb2d97a62
BLAKE2b-256 checksum
How to use checksums
9d29ed7478f80de49e8b87d40c15f61e0b9d3bbcdcf3c934a3076d7702680c32
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 18, 2026.

Transparency log

Security for ai4burmese 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ai4burmese-1.0.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page