Kumaoni (कुमाऊँनी) Language Library for Python
A standard-library-style Python package for the Kumaoni language (कुमाऊँनी / Central Pahari). Designed to be as simple, fast, and comprehensive for Kumaoni as Python's built-in math library is for mathematics.
This library empowers developers to build web applications, mobile apps, educational tools, chatbots, and perform universal translation from any language of the world into Kumaoni.
📖 Full Reference Manual: Check out DOCUMENTATION.md for the exhaustive guide, complete API references, grammatical rules, and application recipes.
🌟 Key Features
-
Universal Multi-Language Translator
- Translate from any world language (English, French, Spanish, German, Japanese, Russian, Arabic, Hindi, Bengali, etc.) into Kumaoni.
- Multi-tiered architecture: Offline rule-based engine + Zero-key universal world language bridge + Neural AI adapter (Gemini / OpenAI).
-
Morphological Verb Conjugation Engine
- Automatically conjugates regular and irregular Kumaoni verbs (e.g.,
खाणto eat,जाणto go,करनto do). - Handles tenses (Present, Past, Future, Continuous), person (1st, 2nd, 3rd), gender (Masculine/Feminine), and honorific forms.
- Auxiliary substantive verb (
छ-/ to be) conjugation.
- Automatically conjugates regular and irregular Kumaoni verbs (e.g.,
-
Kumaoni Numbers & Numerals
- Converts any integer (0 to 1,000,000,000+) to Kumaoni words in Devanagari or Romanized script.
- Converts Kumaoni words back to numbers.
- Supports ordinals (1st
पैलो, 2ndदुसर, 3rdतेसर...), customary fractions (आधो,पाव,पौण,सवा,डेढ़), and Devanagari numerals (०१२३४५६७८९).
-
100,000+ Words Morphological Paradigm Engine & Lemmatizer
- Synthesizes and indexes 455,530+ unique authenticated Kumaoni word forms across verbal paradigms (Present, Past, Future, Continuous, Imperatives, Causatives, Participles, Agentives), nominal declensions (Direct, Plural, Oblique, Case postpositions bound/spaced, Diminutives, Echo words), and adjectival agreements.
- Sub-millisecond
kumaoni.lemmatize()andkumaoni.analyze()for inflected surface forms. - Seamless dictionary lookups: querying inflected forms like
खान्छू,ग्यूँ,ईजा कणी, orघरबटिresolves directly to their base lemmas and definitions.
-
Rich Lexicon & Dictionary (2,138+ Authenticated Base Lemmas)
- Search across Kumaoni, English, and Hindi.
- Sourced from Grierson's Linguistic Survey of India (Vol. IX, Part IV), Pt. Ganga Datt Upreti's Proverbs & Folklore of Kumaun (1894), Badri Datt Pande's Kumaun ka Itihas (1937), Dr. Trilochan Pandey's Kumaoni Bhasha Aur Sahitya (1977 Appendix ग), Rev. E. S. Oakley & Tara Dutt Gairola's Himalayan Folklore (1935), Hem Pant's Ghughuti Basuti (2022), and Uttarakhand Open University's Kumaoni Bhasha Sahitya (AECC-K-101) textbook.
- Categorized by mountain hydrology & terrain (
उकालो,ओड्यार,करांइ,सिमार,बगड़,गधेरा,रोड,खाल,काँठ), hill architecture & implements (चाख,जांतर,उखल,मुसळ,पाथर,दथुड़ो,गागर,फुंगइ,छयो,लुकुड़,चुकती), agriculture & flora (पुंगरण,बाखड़,जुनाल,ध्वाघ,काकुनि,बकौल,कणिक,फिण,मौहट,चूक,किलमोड़ा,हिसोलू,अखोइ,आडू,तिमुल,दाड्मि,कुसम्यारु,गलगल,जमीर,मेहल,कौल कप्फू,बाँझ,देवदार,उतीस,चीड़,सुरई,खर्सू,पांगुर,भट्ट,गहत,राजमा,झंगोरा,मडुवा,भांग,जख्या,गन्द्रायणी,जम्बू), sensation, anatomy & states (खाप,रीस,कलिजो,खाज,कन्या,चिले,कीक,खुजे,बादुइ,पलो,घाम), historical governance & land tenure (बूढ़ा,स्याणा,कामीन,थोकदार,थातवान,खायकर,सिरतान,गूठ,रौत), shamanic & sacred rituals (जागरिया,डांगरिया,हुड़किया,हुड़का,बगंबर,थात,डौँर,आंछरी,मसाण), and alpine pastoralism (छानि,खर्क,बुग्याल,शौका,रंग-भंग,लाप्चा,हुणिया). - Sourced and enriched with core poetic terms from the Kumaoni Digital Heritage Corpus and complete song verses (
मैता,हियो,नराई,जुन्याली,दगड़िया,बाना,जोबन,फाग,चीर,दमुवां,अबीर,चुनर,छैला,सिलिंग,लिबोंग,पाती,झुरण,पीर,सुरति,कजला,मुखड़ी,बैरी,बण,छ्वोरी,पधान,झुमुका,नथुली,पौंछी,हंसुली,घस्यारी,रोपाई,कौतुक,झोड़ा,चाँचरी,छपेली,न्योली,हुड़को,बाँसुरी,मुरुलि,ककड़ी,लौंग,पिछौड़ा,बुराँश,फ्यूँली). - Enriched with traditional folk musical instruments & performance (
हुड़का,दमुवां,रणसिंगा,तुरही,डौंर,कांसी की थाली,मसकबीन,मोचंग,हुड़किया,डांगरिया,जागरिया), marriage ceremonies & rituals (ब्यो/ब्याह,जन्यांत,जंत,जन्यांती,धुलिअर्घ,पिथ्याँ,रंग्वाली पिछौड़ा,अंचल,रतजगा,मातृका पूजा,शकुनाखर,भातखाई,गौना,सौरास,मैत,दामकाज), extended kinship, family & social relations (बड़ाबाबु,बड़ीईजा,काका,काकी,मामा,मामी,मौसा,मौसी,फुफा,फूफू,भाणज,भाणजी,सौर्या,सासू,जेठ,जेठानी,देवर,देवरानी,नणद,नंदोई,साला,साली,साढू,गौंत्यार,हितैषी,नातेदार,कुटुंब,खानदान), sacred Himalayan geography (धाम,देवाल,मन्दिरा,थान,द्युप्त,नौला,धारा,कुंड,संगम,प्रयाग,तीरथ,परिक्रमा,जात,डोलि,निशान,हिमनद,डांडा,धुरा), and historical Kumaoni surnames & clans (पंत,जोशी,पाण्डे,उप्रेती,तिवारी,पाठक,भट्ट,बिष्ट,रावत,नेगी,मेहरा,फर्त्याल,भंडारी,कार्की,रौतेला,मनराल,बोरा,अधिकारी,मेहता,दानू,कोरंगा,पांगती,मर्तोलिया,टम्टा,आर्य). - Phonetic Latin transliteration and Devanagari script normalization.
-
Folklore, Folk Songs & Classical Holi Corpus (20 Songs, 20 Holi Songs & 7 Digital Archives)
- 20 Traditional & Recorded Folk Songs (
KSN-0001toKSN-0020): Complete multi-stanza authentic lyrics, Devanagari verses, English translations, cultural context, and themes (Bedu Pako Baro Masa, Ghughuti Na Basa, Kafal Pako Chait, Myar Shobhani Hosyaara, Teri Khuti Meri Salaam, Maathu Maathu Hitaili Meri Baana, Yo Baato Ka Jaanya, Jhan Diya Bojyoon Chhaana Bilori, Gopal Babu Goswami classics: Kaile Baaji Muruli, Haay Teri Rumaala, Chhooti Ge Nainitaal, O Bhina Kasak, etc.). - 20 Classical Kumaoni Holi Songs (
KHL-0001toKHL-0020): Preserved across Baithaki Holi, Khadi Holi, and Mahila Holi mapped to classical Hindustani raags (Khamaj, Kafi, Dhrupad/Dhamar, Desh/Sorath, Bhairavi, Pilu, Bihag, Yaman, Jhinjhoti, Kalyan). - 7 Active Digital Heritage Archives (
SRC-001toSRC-007): Cataloguing primary repositories including Kumauni Archives, Kumaoni Holi Archive, Kumauni.in, Uttarakhand Library Hub, Open Library, Google Books, and Creative Uttarakhand.
- 20 Traditional & Recorded Folk Songs (
-
Local Deities of Kumaon (40 Supreme Gods & Goddesses / लोक देवी-देवता)
- Dedicated programmatic registry
kumaoni.deitieswith complete oral history, shrines, iconography, and invocation jagars across 5 categories:- Nyaya Devta (Gods of Justice): Golu Devta (Chitai, Ghorakhal, Chamarkhan), Kotgari Devi (Pankhu, Thal).
- Kuldevi / Shakti (Mother Goddesses): Nanda Devi & Sunanda Devi (Almora, Nanda Kot), Maa Barahi Devi (Devidhura), Maa Purnagiri Devi (Tanakpur), Kasar Devi (Almora), Jhula Devi (Ranikhet), Naina Devi (Nainital), Kot Bhramari (Baijnath / Garur), Dunagiri Devi (Dwarahat), Syahi Devi (Shitlakhet).
- Gram Devta & Kshetrapal (Territorial & Village Guardians): Bhumia Devta (Universal village hearth guardian), Bholanath (Almora), Kailpal Devta, Saim Devta & Jhakar Saim, Chipla Kedar (Dharchula alpine tarn), Gabla Devta (Johar & Darma passes), Chhurmal Devta, Khandanath, Masan Devta, Ranbhoot, Bhairav Devta.
- Jagar Deities & Heroic Spirits: Ganganath (Katarmal), Kalbisht / Kaluwa (Binsar), Airy Devta, Chaumu Devta, Lakhia Bhoot (Sor Hillyatra), Jiya Rani (Queen warrior of Ranibagh), Haru Devta, Nagaraja & Panchnag (Berinag, Sem Mukhem), Ghatku Devta, Narsingh Devta, Ainchari (Fairy nymphs), Balchan & Dhannar, Malushahi & Rajula.
- Dedicated programmatic registry
-
Traditional Festivals & Historic Melas (40 Major Celebrations)
- Full calendar details, rituals, regional significance, and search via
kumaoni.festivals.search(q):- Harela, Phool Dei, Ghughutiya / Uttarayani Mela, Olgia / Ghee Sankranti, Nanda Devi Mela, Khatarwa, Saatu-Aathu (Gaura-Mahesh), Bagwal of Devidhura, Syalde-Bikhoti (Dwarahat), Jageshwar Shravani Mela, Purnagiri Mela, Kainchi Dham Mela (15 June), Kumaoni Baithaki & Khadi Holi, Hillyatra (Pithoragarh), Chaitol, Somnath Mela (Masi), Chhipla Jaat, Bagnath Shivratri Mela, Kailpal Mela, Nanda Raj Jaat, Kandali Festival (Chaudas 12-yr bloom), Jauljibi Mela (Indo-Tibetan-Nepali confluence), Thal Mela (Baisakhi), Gananath Mela (Kartik Purnima fertility vigils), Chaiti Mela (Kashipur), Mostamanu Mela (Pithoragarh rain god), Bhitauli (Chaitra sisters gift), Janopunyu (Raksha Bandhan), Vat Savitri, Basant Panchami, Kot Bhramari Mela, Chitai Golu Mela, Ganga Dussehra, Kumaoni Diwali Bhelo, Dronagiri Mela, Devidhura Ashtami, Ghantakarna Mela, Malushahi Mela, Berinag Nagpanchami, Rung Kirji & Gabla Puja.
- Full calendar details, rituals, regional significance, and search via
-
Sacred Geography, Temples & Himalayan Landscape (47 Sacred Places)
- Complete architectural, spiritual, and geographical registry via
kumaoni.places:- Temples & Sacred Dhams (22 shrines): Jageshwar Dham (124 stone temples, 8th Jyotirlinga), Baijnath, Bagnath (Saryu-Gomti confluence), Patal Bhuvaneshwar (subterranean cave), Chitai Golu Devta (temple of bells and justice), Katarmal Sun Temple (Bara Aditya), Kasar Devi (Crank's Ridge geomagnetic belt), Haat Kalika Gangolihat, Maa Barahi Devidhura, Maa Purnagiri, Kainchi Dham (Neem Karoli Baba ashram), Dunagiri, Binsar Mahadev, Mukteshwar, Naina Devi, Kot Bhramari, Mostamanu, etc.
- Rivers & Holy Sangams (10 waterways): Saryu, Gomti, Kali / Sharda, Gori Ganga, Eastern Ramganga, Kosi, Gaula, Bageshwar Sangam, Jauljibi Sangam, Pancheshwar Sangam.
- Alpine Peaks & Glaciers (7 massifs): Nanda Devi (7,816m), Trishul (7,120m), Panchachuli (6,904m), Om Parvat (6,191m), Adi Kailash (5,945m), Pindari Glacier, Milam Glacier.
- Historic Valleys & Towns (8 centers): Johar Valley, Darma Valley, Vyas Valley, Almora, Nainital, Champawat, Munsyari, Dwarahat.
- Complete architectural, spiritual, and geographical registry via
-
Kumaoni Surnames, Clans, Lineages & Social Structure (33 Surnames & 8 Social Concepts)
- Comprehensive sociological and genealogical registry via
kumaoni.surnames:- Brahmin Clans: Pant (Jaideo Pant lineage, Shandilya gotra, royal physicians and poets), Joshi (Garga/Kaushika gotra, Diwans and astrologers), Pandey / Pande (Bharadwaj gotra, preceptors and historians), Upreti (Uprara origin, authors and priests), Tiwari / Tripathi, Pathak, Bhatt (Jageshwar temple priests), Upadhyay, Sanwal, Kholiya.
- Kshatriya / Rajput Clans: Bisht (Vishisht title, feudal commanders), Rawat (feudal chiefs and explorers), Negi (military officers holding Neg perquisites), Mehra / Mahara (leaders of historic Mahara faction), Fartyal (leaders of Fartyal faction), Bhandari (treasury custodians, hero Kalu Bhandari), Karki, Rautela (Chand princes), Chand (sovereign dynasty), Manral (Katyuri princes), Bora, Adhikari, Mehta, Danu, Koranga.
- Shauka / Alpine Bhotia Clans: Pangtey (Milam/Johar scholars and merchants), Martolia (Martoli village beneath Nanda Devi), Rawat (Johari) (Pandit Nain Singh Rawat, Survey of India explorer), Jangpangi, Garbiyal.
- Shilpkar & Artisan Clans: Tamta (Almora master coppersmiths & social reform leaders), Arya (freedom movement pioneers), Lohar (agricultural ironsmiths).
- Social Concepts: Thaat (ancestral landed estate), Thaatwaan (original landholder), Dhadha (factional court alliances), Gauntyaar (fellow villagers), Biraadari (clan brotherhood), Gotra, Neg-Jog, Jajmaani.
-
Himalayan Ethnobotany & Sacred Flora (71 Species / हिमालयी वनस्पति व पादप)
- Comprehensive botanical, ecological, and spiritual registry via
kumaoni.flora:- Sacred & Ritual Trees (14 species): Banjh (Quercus leucotrichophora - mother oak of water aquifers), Buransh (Rhododendron arboreum - state tree), Deodar (Cedrus deodara - Jageshwar sacred grove), Panya / Padam (Prunus cerasoides - hawan samidha), Surai (Cupressus torulosa - temple spires), Bhojpatra (Betula utilis - sacred birch bark), Ringal (Thamnocalamus spathiflorus - Nanda Devi umbrella basketry), Bheemal (Grewia optiva - winter fodder & selu ropes), Pipal, Bar / Bargad, Utees (Alnus nepalensis - Himalayan alder), Semal (Bombax ceiba - red silk cotton), Toon (Toona ciliata - red cedar for temple doors), Reetha (Sapindus mukorossi - soapnut cleanser for murtis), Aanwla (Phyllanthus emblica - Amla Navami sacred tree).
- Sacred Alpine Flowers & Herbs (11 species): Brahmakamal (Saussurea obvallata - supreme offering to Nanda Devi & Shiva), Phen Kamal, Kasturi Kamal, Phyunli (Reinwardtia indica - spring flower of Phool Dei), Tulsi (courtyard chauris), Bithar / Dhoop (Juniperus indica - alpine smudge incense), Guchhi (Morchella esculenta - wild Himalayan morel), Dhatura, Bhang, Kunja (Himalayan wild white rose), Genda (Marigold deity garlands).
- Medicinal & High-Altitude Aromatics (11 species): Jatamansi / Balbachh (Himalayan spikenard incense), Dhoop-lakdi (Jurinea macrocephala), Guggul, Gandrayani (Angelica glauca), Jambu / Faran (Allium stracheyi), Jakhya (Cleome viscosa), Kutki (Picrorhiza kurroa), Ateesh, Chirayata, Kapur Kachari (Hedychium spicatum - perfumed ginger-lily root for hawan), Harad (Terminalia chebula), Baheda (Terminalia bellirica), Thuner (Taxus wallichiana - Himalayan yew).
- Wild Mountain Fruits & Shrubs (20 species): Kafal (Myrica esculenta - iconic spring berry), Bedu (Ficus palmata - wild fig), Timul (Ficus auriculata - eco-friendly feast leaf plates), Kilmoda (Berberis asiatica), Hisolu (golden raspberry), Akhod (Walnut), Choolu (wild apricot temple lamp oil), Galgal (mountain lemon), Daam (wild sour pomegranate), Aadu (peach), Khumaani (apricot), Pulam (plum), Maalta (hill blood orange), Sisoon / Bichhu Ghas (stinging nettle), Gethi (air potato), Tarur (wild forest yam), Maalu (camel's foot creeper for leaf plates), Chyoon (wild oak mushrooms), Linguda (fiddlehead fern).
- Sacred Grasses, Millets & Crops (12 species): Kush (Desmostachya bipinnata - sacrificial Pavitri ring), Durva / Doob (Ganesha green shoots), Jhangora (Barnyard fasting millet), Maduwa / Koda (Finger millet), Bhatt (Black soybean), Bhaang (Cannabis sativa seeds for chutney & fiber), Bhangjeera (Perilla frutescens aromatic seeds), Gaderi / Pinalu (Colocasia taro tuber), Rai / Rayas (pungent mustard greens), Kauni (foxtail millet), Cheena (proso millet), Gahat / Kulath.
- Comprehensive botanical, ecological, and spiritual registry via
-
Temple Implements, Sacred Paraphernalia & Rituals (69 Sacred Items / मन्दिर व पूजा सामग्री)
- Programmatic cataloguing of temple architecture, vessels, and sacred implements via
kumaoni.rituals:- Sacred Marks & Consecrated Threads (10 items): Pithyan (sacred vermilion-turmeric forehead mark), Akshat (unbroken raw rice), Kalawa / Mauli / Rakshasutra (protective wrist thread), Janeu / Yajnopavita (initiatory three-strand thread), Roli, Chandan, Bhabhoot / Bhasma (holy ash from temple dhooni), Baati (hand-rolled cotton lamp wick), Jantar / Taweez (consecrated protective silver amulet), Kaali Dori (consecrated black protective thread for infants).
- Vessels & Consecrated Offerings (16 items): Panchapatra (copper ritual tumbler), Aachmani (libation spoon), Argha (Shivalinga drip vessel), Kalash (Varuna cosmic pot), Aarti ki Thali, Dhoopdani (brass incense burner), Rot (thick wheat-jaggery bhog of Bhumia & Golu), Panchamrit (5 sacred elixirs), Batasha, Deewa / Deeyo (consecrated clay/brass oil lamp), Dhupeli (incense brazier), Kamandal (ascetic holy water vessel), Pattal (leaf plate from Malu leaves), Dona (folded leaf cup for panchamrit), Dhaar (continuous milk/water libation over Shivalinga), Tarpan Paatra (copper libation dish for pitrus).
- Hawan & Sacrificial Paraphernalia (7 items): Hawankund (pyramidal copper altar), Samidha (dried twigs of wild cherry, pipal, and oak), Sruwa (long carved wooden ghee ladle), Sruch, Kapoor (pure white camphor ignited during Maha Aarti), Loban (purifying benzoin resin), Guggal (sacred bdellium gum).
- Temple Insignia & Votive Offerings (12 items): Ghant / Ghanti (temple brass bells, thousands offered at Chitai), Shankha (dawn/dusk aarti conch), Trishul (sacred iron trident), Bana / Nishan (temple processional flag), Paati (judicial prayer petitions pinned at Chitai Golu Devta), Chanwar (yak-tail whisk), Chhatra (silver deity canopy), Doli (sacred palanquin), Jhaanjh (heavy brass clash-cymbals), Jhaanjhar (melodious temple rim cymbals), Chimta (Nath yogi sacred tongs), Dhwaj / Neja (triangular deity flag and lance).
- Jagar & Shamanic Implements (7 items): Hurka (hourglass drum played by Jagariya), Daur (rattle drum), Kansi ki Thali (bell-metal plate inducing trance in Dangariya), Bagambar (meditation seat), Saangal (sacred iron trance chains), Damru (hourglass drum of Lord Shiva), Morpankh Jhaad (peacock-feather healing blessing whisk).
- Sacred Attire & Ornaments (8 items): Rangwali Pichhaura (traditional dotted saffron stole), Aanchal (sacred nuptial knot cloth), Khadaun (wooden ritual sandals), Baagh-Nakh (silver tiger-claw pendant for children), Suhaag Pitaari (wicker bridal cosmetics casket), Nath / Nathuli (monumental gold nose ring), Paunchi (gold bead velvet bracelet), Guloband (traditional gold and velvet choker).
- Sacred Water & Sanctum Features (9 items): Naula (sacred stone spring stepwell with serpent shrine), Dhaara (carved stone spout), Dhooni (perpetual ascetic ash fire), Pindi (natural stone idol), Thaan (open-air village hearth shrine), Dewaal (stone temple complex), Gangajal, Kusha Asan (sacred grass seat), Bhandaar (consecrated temple storehouse).
- Programmatic cataloguing of temple architecture, vessels, and sacred implements via
-
School, Jobs, Governance, Home, Crockery, Child Lifecycle & Movement Vocabulary
- School & Education: ईस्कूल (school), चटशाल (traditional primary pathshala), मास्साब (schoolmaster), गुरुजी (preceptor), च्यला-च्यली (pupil boy/girl), पाथरी (stone slate), बत्ती (slate pencil), दुधि-खड़िया (white chalk), मसवाणी (inkpot), मसि (pine lampblack ink), नरकट (reed pen), कागत (paper), पोथी (manuscript), चोपड़ी (exercise notebook), झोली (satchel), बस्ता, घंटी, बांचण (to read aloud), घोटण (to memorize by rote), परखा (exam), गुणी, पठवार.
- Jobs, Government Service & Administration: सरकारी नौकरी (coveted government job), सर्करी नकर (public servant), रोजगार, तलब / तनख्वाह (monthly salary), ब्याण (daily wage), पैंसन (pension), भत्ता (allowance), हाकिम (magistrate), अफसर (officer), पटवारी (hill revenue & police officer), कानूनगो, बाबू (office clerk), मुंशी (court scribe), चपरासी (peon), कचहरी (district court), दफ्तर (office), तहसील, ठाणा, अर्जी (petition), दरखास्त (application), मिसिल (court case file), मोहर (official seal), दस्तखत (signature), अंगूठा छापो (thumb impression), बही-खाता (ledger), टिकट (revenue stamp).
- Business, Commerce & Trade: ब्यापार (trade), कारोबार, दुकान, बणिया (grocer), महाजन / साहुकार (moneylender), गराक (customer), सौदा (bargain deal), बयाना (advance payment), पूँजी (capital), लागत, नफा / मुनाफा (profit), तोटा / घाटा (loss), उधारी, ऋण, सूद, ब्याज, बट्टा (discount), तराजू-बाँट (weighing scale & weights), शौका ब्यापारी (historic trans-Himalayan merchant).
- Crime, Corruption, Scams & Justice: घूस / रिश्वत (bribe), डाली-भेंट (customary bureaucratic extortion), हाथ गरम करण (to grease palm), घोटाला (financial scam), गोलमाल (fraudulent foul play), ठग (swindler), ठगी (swindle), छल-कपट, धोखाधड़ी, जालसाजी (forgery), हक मारण (usurping rights), चूंघण (extortion), चोरी, चोर, डाका (dacoity), डकैत, लूट-खसोट, सेंध मारण (burglary through wall), जेबकटो (pickpocket), हथकड़ी (handcuffs), हवालात (lockup), कैदखाना (jail), मुलजिम (accused), गवाह / गवाही, फैसला, सजा, जमानत.
- Home Things, Kitchenware, Utensils & Crockery: भाण्ड / बासन (utensils & crockery), गागर / ताँबी (large hammered copper spring water vessel), फुंगई (small brass pitcher), लोटा, मटुको (earthen clay pot), हँड़िया (clay stew pot), थलिया (dinner plate), बटकी (bell-metal bowl), डब्बू (deep ladle), कड़छी, छयो (flat wooden rice paddle), तवा, कड़ाही, चिमटो (hearth tongs), सँड़ासी (pot pincers), फुकणी (hearth blowpipe), सिल-लोटा (granite grinding stone & roller), जांतो (stone rotary quern), ढीकी (foot-operated paddy pounder), ठेकी (wooden butter-churning cylinder), मधानी (churner rod), नेती (churning cords), सुपो (winnowing scoop), डलिया, डोका (conical back-basket), नाम (tumpline headstrap), मोष्ट / मौहट (hemp/straw sitting mat), पीढ़ा (wooden stool), चुलहो (clay kitchen hearth), ओदान (iron hearth trivet), कौलो (burning embers), छार (wood ash), ताखली (wall niche), सन्दूक (timber heirloom chest), खाट, गूंदड़ो (patchwork quilt), तुषक (mattress), कुचो (grass broom), ताला-कुंजी, गोठ (ground-floor stable), मांज (upper residential floor), तिबारी (carved balcony).
- Children, Infancy, Movements, Baby Rites & Games: नान्तिन (children), नानिन (tiny infant), दूधपितो (nursing baby), नानबाबू, नानिबेटी, दुलारो, हियाक टुको (piece of heart), चुलबुलो, ढीठ, गाथुली सरण (baby crawling on belly), घुटन हिटण (crawling on knees), लडबड हिटण (taking unsteady first toddler steps), डगमग हिटण, ठुमक-ठुमक हिटण (joyful toddler stomping steps), तुत-तुत बोलण (baby babbling), तोतलौण (toddler lisp), च्याँखटण (shrill crying), बिलखण (sobbing), राँव-राँव करण (whimpering), कोल्यों बैठण (cuddled in mother's lap), काँखड़ी लैण (carrying on hip), पुठ्याव लैण (piggyback), अँगूठो चूसण, मुसकौण, कुलकुलौण, घूघूती बासुती (clapping rhyme), निनूड़ी (cradle lullaby), न्वाण (11th-day naming rite), छठी (6th-night destiny rite), पास्नी / भात-ख्वाई (first cereal feeding at 6 months), ज्यूँड़ कापण (temple tonsure / mundan), कान छेकण (ear piercing), नजर उतारण (dispelling evil eye), कालो टीको, गण्डो (consecrated black thread), बाघ-नख (silver tiger claw pendant), घुघुता (necklace pastries on Kauva Tyar), खिलोना (wooden toy), भौंरो (spinning top), गुल्ली-डण्डा, गीटी (five stones), बाटी (marbles), छुक-छिपाणी (hide-and-seek).
- Jagar & Shamanic Implements (5 items): Hurka (hourglass drum played by Jagariya), Daur (rattle drum), Kansi ki Thali (bell-metal plate inducing trance in Dangariya), Bagambar (meditation seat), Saangal (sacred iron trance chains).
- Sacred Water & Sanctum Features (7 items): Naula (sacred stone spring stepwell with serpent shrine), Dhaara (carved stone spout), Dhooni (perpetual ascetic ash fire), Pindi (natural stone idol), Thaan (open-air village hearth shrine), Dewaal (stone temple complex), Gangajal.
- Sacred Attire & Knots (2 items): Rangwali Pichhaura (traditional dotted saffron stole), Aanchal (sacred nuptial knot cloth).
-
Cultural Treasury & Master Bibliography (अखाण, आणा, लोकगीत, महागाथा & ग्रन्थ-सूची)
- 85+ Authentic Proverbs (Akhaan): From Pt. Ganga Datt Upreti (1894), UOU AECC-K-101 (2020), and living oral lore with literal, figurative, Hindi, and English equivalents.
- 157+ Authentic Idioms & Folk Phrases (Muhavare & Batkoli): From oral conversations and UOU syllabus Unit 5.
- 43+ Traditional Riddles (Aan / Aana): Folk puzzles with hints, cultural context, and solutions.
- 114+ Master Catalogued Books & Bibliography: Programmatic query interface
kumaoni.bibliography. - 20+ Canonical Authors & Scholars: Biographies and historical profiles.
- 8 Monumental Folk Epics & Ballads: Malushahi-Rajula, Ajuva Bafaul, Golu Devta, Jiya Rani, Veer Balak Haru Singh Heet, Amar Gopichand Yogi, Kalu Bhandari, and Ganganath.
- Interactive Developer Playground & CLI
- Built-in command line interface (
kumaoni translate,kumaoni lookup,kumaoni number,kumaoni bibliography). - Modern glassmorphism web playground running locally with zero dependencies.
🚀 Installation
Install via pip directly from PyPI:
pip install kumaoni
Or install from GitHub source in development mode:
git clone https://github.com/infoakshatsinghbisht-eng/kumaoni-language-library.git
cd kumaoni-language-library
pip install -e .
📖 Quickstart Guide
1. Universal Translation
import kumaoni
# Translate from English to Kumaoni
result = kumaoni.translate("Where is the hospital?", source="en")
print(result) # Output: अस्पताल कतुक दूर छ?
print(result.romanized) # Output: Aspataal katuk door chha?
# Translate from any world language (e.g., French, Spanish, Hindi)
fr_result = kumaoni.translate("Comment allez-vous?", source="fr")
print(fr_result) # Output: कस छू तुम?
hi_result = kumaoni.translate("मुझे पानी चाहिए।", source="hi")
print(hi_result) # Output: मैंकणी पाणि चाही।
2. Verb Conjugator
import kumaoni
from kumaoni.constants import Tense, Gender
# Conjugate 'जाण' (to go) in the past tense for 1st person
past_form = kumaoni.conjugate("जाण", tense=Tense.PAST, person=1, gender=Gender.MASCULINE)
print(past_form) # Output: 'ग्यूँ' (I went)
# Conjugate 'खाण' (to eat) in the future tense
future_form = kumaoni.conjugate("खाण", tense=Tense.FUTURE, person=1)
print(future_form) # Output: 'खालूँ' (I will eat)
# Auxiliary verb 'to be' (छ-)
is_form = kumaoni.conjugate_to_be(tense=Tense.PRESENT, person=3)
print(is_form) # Output: 'छ' (is)
# Morphological Participles & Agent Nouns
print(kumaoni.conjunctive_participle("खाण")) # 'खाईबेर' (having eaten)
print(kumaoni.agent_noun("गाण")) # 'गाण्या' (singer)
print(kumaoni.imperative("औण", polite=True)) # 'आया' (please come)
# Causatives & Compound Verbs
print(kumaoni.causative("करण", degree=1)) # 'करौण' (to make someone do)
print(kumaoni.causative("खाण", degree=1)) # 'खिलाण' (to feed)
print(kumaoni.compound_verb("खाण", "हाल्ण")) # 'खाईहाल्ण' (to eat up completely)
# Passive & Medio-Passive (Inability with -बटि)
print(kumaoni.passive("करण")) # 'कर्यो जान्छ' (is done)
print(kumaoni.medio_passive_inability("मैं", "हिंण")) # 'मैंबटि हिंड्यो नी जाँछ।'
# SOV Sentence Builder & Conditionals
sent = kumaoni.build_sentence(subject="राम", direct_object="भात", verb="खाण")
print(sent) # 'राम भात खान्छ।'
cond = kumaoni.conditional("बरखा होली", "हम घर म रौला")
print(cond) # 'जै बरखा होली, त हम घर म रौला।'
# Relative-Correlative Clauses (सम्बन्धवाचक रचना)
print(kumaoni.relative_correlative("मेहनत करलो", "फल पालो", marker_type="who"))
# Output: 'जो मेहनत करलो, सो फल पालो।'
# Prohibitive Commands (निषेधात्मक आज्ञा - झनि)
print(kumaoni.prohibitive("जाण", polite=True)) # 'झनि जाया' (Please do not go)
print(kumaoni.prohibitive("रोण", polite=True)) # 'झनि रोया' (Please don't cry)
# Modals: Ability, Obligation, and Desideratives
print(kumaoni.modal_ability("मैं", "हिंण")) # 'मैं हिंडि सकन्छू।' (I can walk)
print(kumaoni.modal_obligation("तुम", "काम करण")) # 'तुमकणी काम करण चाही।' (You should work)
print(kumaoni.modal_obligation("मैं", "जाण", strong=True)) # 'मैंकणी जाण पडलो।' (I will have to go)
print(kumaoni.modal_desiderative("मैं", "भात खाण")) # 'मैं भात खाण चान्छू।' (I want to eat food)
# Interrogative Questions (प्रश्नवाचक रचना)
print(kumaoni.interrogative_sentence("कहाँ", subject="अस्पताल")) # 'अस्पताल कहाँ छ?'
print(kumaoni.interrogative_sentence("क्या", subject="तुमार नाम")) # 'तुमार नाम क्या छ?'
3. Numbers & Devanagari Numerals
import kumaoni
# Integer to Kumaoni words
print(kumaoni.num_to_words(42)) # 'बयालीस'
print(kumaoni.num_to_words(108, script="latin")) # 'ek sau aath'
# Ordinals & fractions
print(kumaoni.ordinal(1)) # 'पैलो' (1st)
print(kumaoni.ordinal(2)) # 'दुसर' (2nd)
print(kumaoni.fraction(1, 2)) # 'आधो' (half)
# Devanagari numerals
print(kumaoni.to_devanagari_numerals(2026)) # '२०२६'
print(kumaoni.from_devanagari_numerals("२०२६")) # 2026
# Words back to numbers
print(kumaoni.words_to_num("बयालीस")) # 42
4. Dictionary & Lexicon Search
import kumaoni
# Exact lookup
word = kumaoni.lookup("ईजा")
print(f"{word.kumaoni} -> {word.english} ({word.hindi})")
# Output: 'ईजा -> mother (माँ)'
# Cross-language search
results = kumaoni.search("water")
for w in results:
print(f"{w.kumaoni} ({w.roman}): {w.english}")
# Output: 'पाणि (paani): water'
5. Morphological Lemmatizer & Analyzer (400,000+ Words)
import kumaoni
# Check total synthesized and indexed full-form vocabulary
print(kumaoni.total_word_forms()) # Output: 443,356+ words
# Lemmatize inflected verb forms, case-marked nouns, or postpositions
print(kumaoni.lemmatize("खान्छू")) # 'खाण' (to eat)
print(kumaoni.lemmatize("जाँला")) # 'जाण' (to go)
print(kumaoni.lemmatize("घरबटि")) # 'घर' (house)
print(kumaoni.lemmatize("ईजा कणी")) # 'ईजा' (mother)
# Deep morphological analysis (extracts tense, person, case, number, lemma)
analyses = kumaoni.analyze("खान्छू")
for a in analyses:
print(f"Lemma: {a.lemma}, POS: {a.pos}, Tense: {a.tense}, Person: {a.person}, Number: {a.number}")
# Output: Lemma: खाण, POS: verb_finite, Tense: present, Person: 1, Number: sg
# Seamless dictionary lookup on inflected words
w = kumaoni.lookup("खान्छू")
print(f"Resolved to: {w.kumaoni} -> {w.english}") # Resolved to: खाण -> to eat
6. Script & Phonetics
import kumaoni
# Transliterate English phonetics to Devanagari
print(kumaoni.transliterate("Jai Dev, dajyu kas chou?", to_script="devanagari"))
# Output: 'जय देव, दाज्यू कस छौ?'
# Transliterate Devanagari to Romanized
print(kumaoni.transliterate("पैलाग भुली", to_script="latin"))
# Output: 'pailag bhuli'
7. Cultural Heritage, Literature & Folklore
import kumaoni
# Access Folk Epics (Pauwada / Bhad)
malushahi = kumaoni.literature.get_epic("malushahi")
print(malushahi.title_kumaoni) # 'राजुला मालूशाही'
print(malushahi.synopsis)
# Explore Traditional Valley Poetry (Nyoli / Jhora)
bedu_pako = kumaoni.literature.poems()[0]
print(bedu_pako.title_kumaoni) # 'बेड़ू पाको बारह मासा'
print(bedu_pako.verses_kumaoni[0]) # 'बेड़ू पाको बारह मासा, ओ नरण काफल पाको चैत, मेरी छैला!'
# Canonical Kumaoni Authors & Poets (Gumani Pant, Gaurda, Dr. Charu Chandra Pande)
gumani = kumaoni.literature.get_author("gumani_pant")
print(f"{gumani.name_kumaoni} ({gumani.era}): {gumani.significance}")
# Random proverb (Akhaan) & riddle (Aana)
proverb = kumaoni.proverbs.random()
print("Akhaan:", proverb["kumaoni"], "->", proverb["figurative_meaning"])
riddle = kumaoni.riddles.random()
print("Aana:", riddle["riddle"], "-> Answer:", riddle["answer_kumaoni"])
# Traditional Kumaoni festival information
harela = kumaoni.festivals.get("harela")
print(harela.description)
# Explore Traditional Folk Songs & Holi Music
bedu_song = kumaoni.folklore.song("KSN-0001")
print(bedu_song.title, "->", bedu_song.english_translation)
# Classical Kumaoni Baithaki & Khadi Holi songs
khamaj_holi = kumaoni.folklore.holi_songs(raag="Khamaj")
for h in khamaj_holi:
print(f"[{h.id}] {h.title} ({h.form}, Raag {h.raag})")
# Active Digital Heritage Archives
archives = kumaoni.folklore.sources()
print(f"Preserved archives: {len(archives)} repositories")
# Local Kumaoni Deities & Shrines
golu = kumaoni.deities.get("golu_devta")
print(f"{golu.name_kumaoni}: {golu.title}")
print(f"Primary Shrines: {', '.join(golu.primary_shrines)}")
print(f"Jagar Invocation: {golu.invocation_or_jagar}")
# Sacred Geography & Himalayan Temples (47 Shrines & Landmarks)
jageshwar = kumaoni.places.get("jageshwar_dham")
print(f"{jageshwar.name_kumaoni} ({jageshwar.district}): {jageshwar.spiritual_significance}")
nanda_peak = kumaoni.places.get("nanda_devi_peak")
print(f"{nanda_peak.name_kumaoni} ({nanda_peak.altitude}): {nanda_peak.description}")
# Kumaoni Surnames, Clans & Social Concepts (33 Surnames, 8 Social Concepts)
pant = kumaoni.surnames.get("pant")
print(f"{pant.surname_kumaoni}: {pant.title} | Gotras: {', '.join(pant.gotras)}")
bisht = kumaoni.surnames.get("bisht")
print(f"{bisht.surname_kumaoni}: {bisht.title} | Origin: {bisht.ancestral_villages_or_origin}")
print("Thaatwan Institution:", kumaoni.surnames.social_concepts()["thatwan"]["meaning"])
# Himalayan Ethnobotany & Sacred Trees (43 Plants)
buransh = kumaoni.flora.get("buransh")
print(f"{buransh.name_kumaoni} ({buransh.scientific_name}): {buransh.spiritual_and_temple_significance}")
brahmakamal = kumaoni.flora.get("brahmakamal")
print(f"{brahmakamal.name_kumaoni} (Alt: {brahmakamal.habitat_altitude}): {brahmakamal.traditional_uses}")
# Temple Implements & Sacred Ritual Objects (43 Items)
pithyan = kumaoni.rituals.get("pithyan")
print(f"{pithyan.name_kumaoni}: {pithyan.sacred_purpose} | Material: {pithyan.traditional_material}")
rot = kumaoni.rituals.get("rot")
print(f"{rot.name_kumaoni}: {rot.cultural_context}")
📋 Comprehensive API Function Reference
All key functions are directly accessible via import kumaoni:
| Category | Function / Property | Description |
|---|---|---|
| Translation | kumaoni.translate(text, source='en', target='kumaoni') |
Translate from 100+ world languages into Kumaoni. |
| Voice & Speech | kumaoni.voice_translate(text, ...) |
Voice translation pipeline (text + IPA phonetic script + audio). |
kumaoni.voice.phrases() |
Get categorized authentic conversational phrases. | |
| Dictionary & Search | kumaoni.lookup(word) |
Search base dictionary definitions (Kumaoni, Hindi, English). |
kumaoni.search(query) |
Multi-result search in vocabulary database. | |
| Morphology (300k+ Forms) | kumaoni.lemmatize(word) |
Reduces inflected forms (खान्छू, घरबटि) to base dictionary lemma. |
kumaoni.analyze(word) |
Deep grammatical analysis (POS, tense, case, gender, person). | |
kumaoni.total_word_forms() |
Count of indexed morphological forms (300,000+). | |
| Verb Conjugation | kumaoni.conjugate(verb, tense, person, ...) |
Conjugates verbs across Present, Past, Future, Continuous. |
kumaoni.conjugate_to_be(tense, person, ...) |
Conjugates auxiliary substantive verb (छ- / to be). |
|
kumaoni.imperative(verb, honorific=...) |
Forms imperative commands (खा, खाओ, खाइये). |
|
kumaoni.causative(verb, degree=1) |
Forms 1st and 2nd degree causative verbs (खवाण, खववाण). |
|
kumaoni.passive(verb, tense=...) |
Forms passive voice constructions. | |
kumaoni.conjunctive_participle(verb) |
Conjunctive participle 'having done' (खाईकन, जाईकन). |
|
kumaoni.agent_noun(verb) |
Agentive noun 'the one who does' (खन्या, जन्या). |
|
kumaoni.compound_verb(main, vector, ...) |
Aspectual compound verbs (खा ल्हियो). |
|
kumaoni.prohibitive(verb, honorific=...) |
Negative prohibitive commands (झन् खा). |
|
kumaoni.modal_ability(verb, subject=...) |
Modal ability 'can do' (सकण). |
|
kumaoni.modal_obligation(verb, subject=...) |
Modal obligation 'must / should do' (पड़ण). |
|
kumaoni.modal_desiderative(verb, ...) |
Modal desiderative 'wants to do' (चाण). |
|
| Grammar & Syntax | kumaoni.build_sentence(sub, verb, obj, ...) |
Generates grammatically aligned SOV sentences. |
kumaoni.conditional(cond, conseq) |
Conditional sentences (अगर... तब...). |
|
kumaoni.relative_correlative(rel, corr) |
Relative-correlative clauses (जो... सो...). |
|
kumaoni.interrogative_sentence(sub, ...) |
Question sentences (कहाँ, कबे, क्योँ, को). |
|
kumaoni.echo_word(word) |
Reduplicative echo words (भात-व़ात, किताब-सिताब). |
|
| Nouns & Declension | kumaoni.pluralize(noun, gender=...) |
Pluralizes nouns by declension class. |
kumaoni.decline_noun(noun, case, ...) |
Declines nouns into grammatical cases. | |
kumaoni.to_oblique(noun, ...) |
Oblique stem for postpositions. | |
kumaoni.attach_case(noun, case, ...) |
Attaches vibhakti case markers to noun. | |
kumaoni.get_marker(case) |
Returns case marker postposition (-ले, -कणी, -बटि, -म). |
|
kumaoni.get_pronoun(person, case, ...) |
Resolves personal pronouns across cases. | |
kumaoni.to_feminine(word) / to_masculine |
Converts gender forms of nouns/adjectives. | |
kumaoni.make_diminutive(noun) |
Diminutive affection forms (गाड़ ➔ गड्यूल). |
|
| Numbers & Fractions | kumaoni.num_to_words(number) |
Integer to Kumaoni words (108 ➔ 'एक सौ आठ'). |
kumaoni.words_to_num(words) |
Kumaoni number words to integer. | |
kumaoni.to_devanagari_numerals(n) |
Converts number to Devanagari numerals (२०२६). |
|
kumaoni.from_devanagari_numerals(s) |
Devanagari numerals back to integer. | |
kumaoni.ordinal(n) |
Ordinals (पैलो, दुसर, तेसर, चौथ). |
|
kumaoni.fraction(val) |
Fractions (आधो, पाव, सवा, डेढ़, ढाई). |
|
| Phonetics & Script | kumaoni.transliterate(text, to_script=...) |
Two-way Devanagari ↔ Latin/Roman transliteration. |
kumaoni.devanagari_to_latin(text) |
Transliterates Devanagari into Latin phonetic script. | |
kumaoni.latin_to_devanagari(text) |
Converts Romanized Kumaoni input to Devanagari. | |
kumaoni.normalize(text) |
Normalizes Devanagari diacritics and nuktas. | |
kumaoni.detect_script(text) |
Detects 'devanagari', 'latin', or 'mixed'. |
|
kumaoni.tokenize(text) / syllables(text) |
Tokenizes words and splits phonetic syllables. | |
| Culture & Literature | kumaoni.proverbs.all() / .random() |
85+ Proverbs (Akhaan) with literal & cultural meanings. |
kumaoni.riddles.all() / .random() |
43+ Traditional Riddles (Aana) with hints & answers. | |
kumaoni.phrases.all() / .random() |
157+ Conversational phrases, idioms (Muhavare) & blessings. | |
kumaoni.bibliography.list(category=...) |
114+ Master Catalogued Books (in Kumaoni, grammar, criticism). | |
kumaoni.bibliography.stats() / .search(q) |
Summary statistics and keyword search across master corpus. | |
kumaoni.folklore.songs() / .song(id) |
20 Catalogued Folk & Recorded Songs with lyrics & English meanings. | |
kumaoni.folklore.holi_songs() / .holi_song(id) |
20 Classical Kumaoni Holi Songs (Baithaki, Khadi, Mahila) + Raags. | |
kumaoni.folklore.sources() / .stats() |
7 Digital Heritage Archives & corpus statistics. | |
kumaoni.deities.list() / .get(name_or_id) |
40 Supreme Local Deities (Golu Devta, Nanda Devi, Bholanath, Bhumia...). | |
kumaoni.deities.search(q) / .stats() |
Search deities across 5 categories by shrine, title, legend. | |
kumaoni.festivals.list() / .get(name) |
40 Traditional Festivals & Melas (Harela, Khatarwa, Bagwal, Hillyatra...). | |
kumaoni.festivals.search(q) |
Search festivals by district, lunar tithi, or keyword. | |
kumaoni.places.list() / .get(id) |
47 Sacred Temples, Rivers, Glaciers & Valleys (Jageshwar, Baijnath, Nanda Devi...). | |
kumaoni.places.search(q) / .stats() |
Search holy geography by district, deity, or spiritual significance. | |
kumaoni.surnames.list() / .get(id) |
33 Lineage Surnames & Clans (Pant, Joshi, Bisht, Rawat, Negi, Pangtey, Tamta...). | |
kumaoni.surnames.social_concepts() |
8 Fundamental Kumaoni social concepts (Thaat, Thaatwaan, Dhadha, Gauntyaar...). | |
kumaoni.flora.list() / .get(id) |
71 Sacred Trees, Alpine Flowers, & Medicinal Herbs (Banjh, Buransh, Brahmakamal, Utees, Semal, Bhaang...). | |
kumaoni.flora.search(q) / .stats() |
Search ethnobotanical flora by traditional use, habitat altitude, or category. | |
kumaoni.rituals.list() / .get(id) |
69 Temple Implements, Hawan Vessels, & Paraphernalia (Pithyan, Rot, Ghant, Deewa, Baati, Kapoor, Pattal, Nath...). | |
kumaoni.rituals.search(q) / .stats() |
Search ritual objects by material, sacred purpose, or associated deity/temple. | |
kumaoni.literature.epics() / .get_epic(id) |
8 Folk Epics (Malushahi-Rajula, Jiya Rani, Kalu Bhandari). | |
kumaoni.literature.poems() |
Canonical Kumaoni poems & folk songs. | |
kumaoni.literature.authors() / .get_author(id) |
Biographies of 20+ canonical scholars & poets. | |
kumaoni.get_months() / get_seasons() |
Kumaoni solar calendar months & 6 traditional seasons. | |
kumaoni.get_current_season() |
Calculates active season for today's date. |
For exhaustive explanations and parameter details, see DOCUMENTATION.md.
💻 Command-Line Interface (CLI)
The library provides a CLI tool kumaoni:
# Translate text
kumaoni translate "Where does this road go?" --source en
# Dictionary lookup
kumaoni lookup "काफल"
kumaoni lookup "पिछौड़ा"
# Number to words
kumaoni number 108
# Verb conjugation
kumaoni conjugate "जाण" --tense past --person 1
# Random proverb / riddle
kumaoni proverb
kumaoni riddle
🖥️ Interactive Web Playground
Launch the interactive local web playground to test translation and explore the language in a browser:
python -m kumaoni.web.app 8080
Open http://localhost:8080 in your browser.
📂 Project Architecture
kumaoni/
├── __init__.py # Unified top-level namespace (kumaoni.translate, folklore, literature, etc.)
├── constants.py # Dialects, grammatical constants, solar calendar
├── phonetics.py # Script transliteration, Devanagari normalizer
├── grammar/
│ ├── verbs.py # Verb root extraction & conjugation engine
│ ├── nouns.py # Noun morphology, pluralization, case declensions
│ ├── pronouns.py # Pronoun tables across person, number, and case
│ └── postpositions.py # Karaka markers (-ले, -कणी, -बटि, -म, etc.)
├── numbers/
│ └── converter.py # Integer to words, ordinals, fractions, numerals
├── lexicon/
│ ├── dictionary.py # Fast search across Devanagari, English, and Hindi
│ └── data/ # Curated JSON datasets (2,380+ base lemmas, 515,744+ word forms)
├── translator/
│ ├── engine.py # Unified translation orchestrator
│ ├── rule_based.py # Rule-based linguistic transfer & dialogue patterns
│ ├── pivot.py # Universal multi-language bridge (Any Language -> Kumaoni)
│ └── llm_adapter.py # Native Gemini/OpenAI neural integration
├── culture/
│ ├── deities.py # 40 Local Deities & Shrines (Golu Devta, Nanda Devi, etc.)
│ ├── places.py # 47 Sacred Temples, Rivers, Glaciers & Valleys
│ ├── surnames.py # 33 Kumaoni Surnames, Clans & Social Concepts (Thaat, etc.)
│ ├── flora.py # 71 Himalayan Sacred Trees, Alpine Flowers & Ethnobotany
│ ├── rituals.py # 69 Temple Implements, Hawan Vessels & Paraphernalia
│ ├── festivals.py # 40 Traditional Festivals & Historic Melas (Harela, etc.)
│ ├── calendar.py # Kumaoni solar months & seasons
│ ├── literature.py # Folk Epics (Malushahi, Bafaul), Nyoli, Jhora, Authors
│ ├── bibliography.py # 114+ Catalogued Works (in Kumaoni, grammar, linguistics)
│ ├── folklore.py # 20 Folk Songs, 20 Holi Songs, 7 Digital Archives
│ └── data/ # songs.json, holi_songs.json, digital_sources.json, books.json
├── voice/ # Phonetic speech synthesis & audio generation
├── cli.py # Command-line interface
└── web/ # Interactive developer playground
📚 Data Sources & Acknowledgments
This library synthesizes datasets and oral cultural heritage from:
- eUttaranchal (Learn Kumaoni linguistic lessons 1–3)
- SpeakKumaoni & PahadiLingo (Himalayan vocabulary & phonetic guides)
- Kumauni Archives & Kumauni Culture (Oral literature, e-books, e-magazines)
- Linguistic Research: Works of Dr. D.D. Sharma (Linguistic Geography of Kumaun Himalayas), Dr. Charu Chandra Pande, G.A. Grierson (LSI), Saraswati Kohli (Kumaoni Kahavatein), Gumani Pant, and Gaurda.
📜 License
MIT License © 2026 Kumaoni Language Initiative. Open-source and free for all developers, linguists, and researchers.
👤 Author & Creator Profile
- Creator & Author: Akshat Singh Bisht
- Official Website: https://akshatsinghbisht.com/
- Email: infoakshatsinghbisht@gmail.com
- LinkedIn: Akshat Singh Bisht on LinkedIn
- Amazon Author Profile: Akshat Singh Bisht on Amazon
- ResearchGate: Akshat Bisht on ResearchGate
- GitHub: @infoakshatsinghbisht-eng
- Kumaoni Repository: https://github.com/infoakshatsinghbisht-eng/kumaoni-language-library
- Garhwali Repository: https://github.com/infoakshatsinghbisht-eng/garhwali-language-library
- Garhwali PyPI: https://pypi.org/project/garhwali/
📄 License
This project is licensed under the MIT License — dedicated to the computational preservation, linguistic research, and cultural advancement of the Himalayan languages of Uttarakhand.
Metadata
Release files for kumaoni 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| kumaoni-1.2.0.tar.gz | 383.3 kB | With provenance | Details for kumaoni-1.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| kumaoni-1.2.0-py3-none-any.whl | Python 3 | none | any | Details for kumaoni-1.2.0-py3-none-any.whl |
Total release size: 729.4 kB
Release files / kumaoni-1.2.0.tar.gz
| Download URL | kumaoni-1.2.0.tar.gz |
|---|---|
| Size | 383.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
152dbcb7893b630bcb99b4ce1559ca34df46f6eed4216d2d0329b2a128d9bed2
|
|
BLAKE2b-256 checksum How to use checksums |
12e6efd17309ab72bca2b931031d4628bc68444d8061ed46b41cec8239d16864
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 8, 2026.
Transparency logRelease files / kumaoni-1.2.0-py3-none-any.whl
| Download URL | kumaoni-1.2.0-py3-none-any.whl |
|---|---|
| Size | 346.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64da38a901fc8e491d1955484040a788e74ebc9ac2e5b822a5e0c53b6a5ae635
|
|
BLAKE2b-256 checksum How to use checksums |
a91aa6afe36e771e1f3a73a9c89f687e222a6881b47d689f961c93b2c44a7f3c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 8, 2026.
Transparency logSecurity for kumaoni 1.2.0
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
Both files in this release have been uploaded with provenance metadata.
Attestation for kumaoni-1.2.0.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 Oct 8, 2026.
Transparency logA 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.