{"id":50663984,"url":"https://github.com/palmshed/llamaware","last_synced_at":"2026-06-08T04:33:43.810Z","repository":{"id":316166759,"uuid":"1049339974","full_name":"palmshed/llamaware","owner":"palmshed","description":"c++ code assistant.","archived":false,"fork":false,"pushed_at":"2026-01-13T06:54:49.000Z","size":51957,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T09:26:13.577Z","etag":null,"topics":["ai","code-assistant","cpp"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"harpertoken/llamaware","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/palmshed.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","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-09-02T20:42:49.000Z","updated_at":"2026-05-31T08:20:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/palmshed/llamaware","commit_stats":null,"previous_names":["bniladridas/llamaware","palmshed/llamaware"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/palmshed/llamaware","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palmshed%2Fllamaware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palmshed%2Fllamaware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palmshed%2Fllamaware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palmshed%2Fllamaware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/palmshed","download_url":"https://codeload.github.com/palmshed/llamaware/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/palmshed%2Fllamaware/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34048681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","code-assistant","cpp"],"created_at":"2026-06-08T04:33:43.741Z","updated_at":"2026-06-08T04:33:43.789Z","avatar_url":"https://github.com/palmshed.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Llamaware\n\n[![CI/CD](https://github.com/harpertoken/llamaware/actions/workflows/ci.yml/badge.svg)](https://github.com/harpertoken/llamaware/actions/workflows/ci.yml)\n[![agent](https://github.com/harpertoken/llamaware/actions/workflows/agent.yml/badge.svg)](https://github.com/harpertoken/llamaware/actions/workflows/agent.yml)\n\n**Llamaware** is a modular AI agent for development — designed for **stability**, **extensibility**, and **security**.\nIt provides core systems for file management, sessions, extensions, AI providers, and GitHub automation.\n\n---\n\n## System Requirements\n\n**Supported Platforms**\n\n* Linux (Ubuntu 20.04+)\n* macOS (15.0+)\n* Windows (MSVC 2019+)\n\n**Compiler**\n\n* C++20 (GCC 10+, Clang 12+, MSVC 2019 16.11+)\n\n**Build System**\n\n* CMake 3.14+\n\n**Version Control**\n\n* Git\n\n**Dependencies**\n\n* cpr ≥ 1.10.0\n* nlohmann-json ≥ 3.10.0\n* OpenSSL ≥ 1.1.1\n* libpqxx ≥ 7.0 (optional, for PostgreSQL)\n\n---\n\n## Project Structure\n\n```\nsrc/core/         → agent logic, command routing\nsrc/services/     → AI, file, web, git, MCP, etc.\nsrc/utils/        → config, UI, validation helpers\ntests/            → unit \u0026 E2E tests\nscripts/          → build \u0026 reporting tools\npackage/docker/   → containerization setup\n```\n\n---\n\n## Installation\n\n```bash\ngit clone https://github.com/harpertoken/llamaware.git\ncd llamaware\n```\n\n### Ubuntu/Debian\n\n```bash\n./scripts/install-deps.sh  # or run manually:\nsudo apt update\nsudo apt install -y build-essential cmake git libcurl4-openssl-dev libpqxx-dev\n```\n\n### macOS\n\n```bash\n./scripts/install-deps.sh  # or run manually:\nbrew install cmake libpqxx\n```\n\n### Windows\n\n```powershell\n# Install Chocolatey, CMake, and vcpkg (see CI workflow)\nvcpkg install libpqxx\n```\n\n---\n\n## Build\n\n```bash\ncmake -S . -B build -DCMAKE_BUILD_TYPE=Release\ncmake --build build --config Release --parallel\n```\n\n---\n\n## Run\n\n```bash\n./build/bin/llamaware-agent\n```\n\n**Basic Commands**\n\n```\nversion\nsearch:query\ncmd:command\nread:/path/to/file\nwrite:/path/to/file content\nhelp\nexit\n```\n\n---\n\n## AI Providers\n\n* Together AI (Llama models)\n* Cerebras (Llama inference)\n* Fireworks (performance-optimized)\n* Groq (speed-focused)\n* DeepSeek (reasoning models)\n* OpenAI (GPT models)\n* Ollama (offline support)\n\n---\n\n## Database Integration (Optional)\n\n**Features**\n\n* Persistent memory and session state\n* Conversation history\n* Automatic schema initialization\n\n**Config**\n\n```bash\nDB_HOST=localhost\nDB_PORT=5432\nDB_NAME=llamaware\nDB_USER=llamaware\nDB_PASSWORD=your_password\n```\n\nEnabled automatically when `libpqxx` is detected at build time.\n\n---\n\n## GitHub Bot\n\nThe agent includes automated GitHub integration for enhanced project management.\n\n**Features**\n\n* **Health Checks**: Runs on pull requests to verify builds, tests, code quality (TODOs/FIXMEs), and preflight checks, posting detailed reports with progress bars and overall status (Operational/Degraded/Unstable).\n* **TODO Management**: Automatically creates sub-issues for TODO items found in issue descriptions, with proper labeling and linking.\n* **Milestone Assignment**: Assigns appropriate milestones to pull requests based on keywords (e.g., 'feature' → Next Release, 'bug'/'fix' → Bug Fixes, 'refactor' → Technical Debt).\n```\n\n---\n\n## CI/CD\n\n**Workflows**\n\n* Build and test (Linux, macOS, Windows)\n* Preflight checks\n* Artifact uploads\n* Code coverage\n\n**Triggers**\n\n* Push to `main` or `develop`\n* Pull requests\n* Release publication\n\n**Repository Variables**\n\n```\nPUSH_BRANCHES   = [\"main\",\"develop\"]\nPR_BRANCHES     = [\"*\"]\nRELEASE_TYPES   = [\"published\"]\n```\n\n---\n\n## Testing\n\n**Unit Tests**\n\n```bash\ncmake -S . -B build\ncmake --build build\ncd build \u0026\u0026 ctest --output-on-failure\n```\n\n**E2E Tests**\n\n```bash\ndocker compose -f docker-compose.e2e.yml up -d\ndocker compose -f docker-compose.e2e.yml logs -f e2e-tests\ndocker compose -f docker-compose.e2e.yml down\n```\n\n---\n\n## Development\n\n**Debug Build**\n\n```bash\ncmake -S . -B build -DCMAKE_BUILD_TYPE=Debug\ncmake --build build --config Debug\n```\n\n**Code Quality**\n\n```bash\n./scripts/setup-pre-commit.sh\nmake clang-tidy\nmake lint-all\n```\n\nRun full checks:\n\n```bash\nmake full-check\npre-commit run --all-files\n```\n\n---\n\n## Conventional Commits\n\n**Commit Format**\n\n```\n\u003ctype\u003e: \u003cdescription\u003e\n```\n\n**Allowed Types**\n`feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`, `ci`, `build`, `revert`\n\n**Examples**\n\n```\nfeat: add user authentication\nfix: resolve memory leak\ndocs: update installation guide\n```\n\n**Setup Hook**\n\n```bash\ncp scripts/commit-msg .git/hooks/\nchmod +x .git/hooks/commit-msg\n```\n\n**Rewriting History**\n\n```bash\ngit filter-branch --msg-filter 'bash scripts/rewrite_msg.sh' -- --all\ngit push --force-with-lease origin main\n```\n\n---\n\n## Troubleshooting\n\n```bash\ndocker ps                # check containers\ndocker logs llamaware-agent\ndocker-compose -f package/docker/docker-compose.yml restart llamaware-agent\n```\n\n---\n\n## Versioning\n\nFollows [Semantic Versioning](https://semver.org/):\n\n| Type  | Description      |\n| ----- | ---------------- |\n| MAJOR | Breaking changes |\n| MINOR | New features     |\n| PATCH | Bug fixes        |\n\n**Version Detection Order**\n\n1. Git tag (e.g., `v0.0.8`)\n2. `VERSION` file\n3. Default fallback\n\n**Release Process**\n\n```bash\n./scripts/bump-version.sh patch\ngit add . \u0026\u0026 git commit -m \"feat: release v0.0.9 [release]\"\ngit push origin main\n```\n\nAuto-releases trigger on `[release]`, with `[major]` or `[minor]` for version bump type.\n\n---\n\n## License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalmshed%2Fllamaware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpalmshed%2Fllamaware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpalmshed%2Fllamaware/lists"}