{"id":29647558,"url":"https://github.com/dowhiledev/vibelang","last_synced_at":"2026-04-30T14:35:56.733Z","repository":{"id":284997589,"uuid":"956156716","full_name":"dowhiledev/vibelang","owner":"dowhiledev","description":"VibeLang is a programming language designed to seamlessly integrate with Large Language Models (LLMs) through native prompt blocks.","archived":false,"fork":false,"pushed_at":"2025-06-06T12:55:23.000Z","size":3465,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-22T03:56:29.865Z","etag":null,"topics":["c","openai","programming-language","vibe-coding","vibelang"],"latest_commit_sha":null,"homepage":"https://dowhiledev.github.io/vibelang/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dowhiledev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-27T19:40:50.000Z","updated_at":"2025-06-06T12:55:24.000Z","dependencies_parsed_at":"2025-05-20T09:27:56.311Z","dependency_job_id":"6e23ceb3-9dd7-43fe-8dea-020b5e9339c8","html_url":"https://github.com/dowhiledev/vibelang","commit_stats":null,"previous_names":["chandralegend/vibelang","dowhiledev/vibelang"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dowhiledev/vibelang","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fvibelang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fvibelang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fvibelang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fvibelang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dowhiledev","download_url":"https://codeload.github.com/dowhiledev/vibelang/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dowhiledev%2Fvibelang/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31978610,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T17:30:12.329Z","status":"ssl_error","status_checked_at":"2026-04-18T17:29:59.069Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","openai","programming-language","vibe-coding","vibelang"],"created_at":"2025-07-22T03:37:49.379Z","updated_at":"2026-04-18T17:36:56.983Z","avatar_url":"https://github.com/dowhiledev.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e\n  \u003cdiv\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/icon-light.svg\" width=\"400\" height=\"100\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"assets/icon-dark.svg\" width=\"60\" height=\"60\"\u003e\n      \u003cimg alt=\"VibeLang Icon\" style=\"vertical-align: middle;\"\u003e\n    \u003c/picture\u003e\n    \u003c!-- \u003cspan style=\"vertical-align: middle; margin-left: 10px;\"\u003eVibeLang\u003c/span\u003e --\u003e\n  \u003c/div\u003e\n\u003c/h1\u003e\n\n\u003cdiv \u003e\n\n[![Tests](https://github.com/dowhiledev/vibelang/actions/workflows/tests.yml/badge.svg)](https://github.com/dowhiledev/vibelang/actions/workflows/tests.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/badge/version-0.1.0-brightgreen.svg)](https://github.com/dowhiledev/vibelang)\n\n\u003c/div\u003e\n\nVibeLang is a statically-typed language designed for natural language interactions with LLM models. It provides a type-safe way to integrate AI capabilities into applications.\n\n## Project Status\n\n- ✅ Milestone 1: Core Compiler Development\n- ✅ Milestone 2: Code Generation \u0026 C API Exposure\n- ✅ Milestone 3: Runtime Library \u0026 LLM Integration\n- 🔄 Milestone 4: Cross-Language Support and Wrappers\n- 🔄 Milestone 5: Comprehensive Testing and Documentation\n\n## Documentation\n\nThe API reference and developer documentation are available [Here](https://dowhiledev.github.io/vibelang/).\n\nYou can also generate the documentation locally using:\n```bash\nmake docs\n```\n\nAnd view it by running:\n```bash\nmake serve-docs\n```\n\n## Features\n\n- Statically typed language with semantic meaning support\n- Direct integration with LLM providers\n- Natural language prompt templates\n- Type-safe API for C and Python\n\n## Runtime Library\n\nThe VibeLang runtime provides:\n\n1. **LLM Connection**: Connect to various LLM providers (currently supports OpenAI)\n2. **Prompt Execution**: Send prompts to LLMs with automatic variable substitution\n3. **Module Loading**: Dynamically load and execute compiled VibeLang modules\n\n### Configuration\n\nLLM settings can be configured in a `vibeconfig.json` file:\n\n```json\n{\n  \"global\": {\n    \"provider\": \"OpenAI\",\n    \"api_key\": \"YOUR_API_KEY_HERE\", \n    \"default_params\": {\n      \"model\": \"gpt-3.5-turbo\",\n      \"temperature\": 0.7,\n      \"max_tokens\": 150\n    }\n  }\n}\n```\n\nAPI keys can also be provided via environment variables:\n- `OPENAI_API_KEY` - For OpenAI API access\n- `VIBELANG_API_KEY` - Generic API key for any provider\n\n## Getting Started\n\n### Prerequisites\n\n- C compiler (GCC or Clang)\n- CMake 3.10+\n- libcurl and cJSON development libraries\n- Bison and Flex (for building the parser)\n\n### Installation\n\n```bash\ngit clone https://github.com/dowhiledev/vibelang.git\ncd vibelang\nmkdir build \u0026\u0026 cd build\ncmake ..\nmake\nsudo make install\n```\n\n### Writing Your First VibeLang Program\n\nCreate a file named `weather.vibe`:\n\n```\ntype Temperature = Meaning\u003cInt\u003e(\"temperature in Celsius\");\ntype Forecast = Meaning\u003cString\u003e(\"weather forecast description\");\n\nfn getTemperature(city: String) -\u003e Temperature {\n    prompt \"What is the current temperature in {city} in Celsius?\";\n}\n\nfn getForecast(city: String, day: String) -\u003e Forecast {\n    prompt \"Provide a brief weather forecast for {city} on {day}.\";\n}\n```\n\nCompile it and integrate the generated C file into your own program:\n\n```bash\nvibec weather.vibe\n# weather.c contains the generated functions\n# compile it together with your application code\ngcc -o weather_app my_app.c weather.c -lvibelang\n# vibec also produces weather.so for dynamic loading\n```\n\nThe runtime automatically initializes itself the first time a generated\nfunction executes. You can still call `vibe_runtime_init()` manually to check\nfor errors or override configuration, but it's optional for simple programs:\n\n```c\n#include \u003cruntime.h\u003e\n\nint main() {\n    // Manual initialization is optional\n    vibe_runtime_init();\n\n    /* call generated functions here */\n\n    // The runtime is automatically shut down at program exit\n    return 0;\n}\n```\n\nThe system needs to locate `libvibelang` at runtime. Either install it in a\nstandard library path, set the environment variable `LD_LIBRARY_PATH` (or\n`DYLD_LIBRARY_PATH` on macOS) to include the installation directory, or compile\nwith an rpath:\n\n```bash\ngcc -o weather_app my_app.c weather.c -lvibelang \\\n    -Wl,-rpath,/usr/local/lib\n```\nReplace `/usr/local/lib` with the prefix used during installation.\n\n## Known Issues\n\n- Function overloading is not yet supported\n- Limited error reporting from LLM providers\n- No streaming support for LLM responses yet\n\n## VS Code Extension\n\nA minimal VS Code extension is included in the `vscode` directory. It provides\nsyntax highlighting for `.vibe` files. To try it out:\n\n1. Open the `vscode` folder in VS Code.\n2. Press `F5` to launch an Extension Development Host.\n3. Open a VibeLang source file to see the highlighting.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdowhiledev%2Fvibelang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdowhiledev%2Fvibelang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdowhiledev%2Fvibelang/lists"}