{"id":31936216,"url":"https://github.com/ibz-04/raya","last_synced_at":"2025-10-14T07:25:13.862Z","repository":{"id":316451015,"uuid":"1056510870","full_name":"iBz-04/raya","owner":"iBz-04","description":" Computer use agent ","archived":false,"fork":false,"pushed_at":"2025-09-24T18:13:34.000Z","size":6962,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-24T18:17:36.037Z","etag":null,"topics":["ai-agent","ai-agents","computer-use","computer-use-agent","desktop-automation","llm-agent","open-ai","open-source","python","windows-automation"],"latest_commit_sha":null,"homepage":"","language":"Python","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/iBz-04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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-09-14T08:46:53.000Z","updated_at":"2025-09-24T18:14:44.000Z","dependencies_parsed_at":"2025-09-24T18:18:12.140Z","dependency_job_id":null,"html_url":"https://github.com/iBz-04/raya","commit_stats":null,"previous_names":["ibz-04/raya"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/iBz-04/raya","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2Fraya","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2Fraya/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2Fraya/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2Fraya/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iBz-04","download_url":"https://codeload.github.com/iBz-04/raya/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2Fraya/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018215,"owners_count":26086303,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"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-agent","ai-agents","computer-use","computer-use-agent","desktop-automation","llm-agent","open-ai","open-source","python","windows-automation"],"created_at":"2025-10-14T07:25:12.575Z","updated_at":"2025-10-14T07:25:13.856Z","avatar_url":"https://github.com/iBz-04.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"- Raya - Computer Use Agent\n\n---\n\n## Introduction\n\n**raya** is an AI agent for raya that harnesses the power of code and AI to control your PC with ease. It enables you to automate any task by interacting with applications, clicking buttons, typing, running commands, and capturing the UI state.\n\n### preview :) \nhttps://github.com/user-attachments/assets/82ab57fe-8e4d-4f37-9516-0001e7e08845\n\n\nUnlike traditional computer vision models, **raya** works directly at the raya GUI layer, providing advanced automation capabilities without relying on image recognition techniques. \n\n\n## Installation\n\n**Requirements:**\n- Python 3.13 or higher\n- windows 7, 8, 10, or 11\n- [UV](https://github.com/astral-sh/uv) (optional, or use pip)\n\n**To install with uv:**\n```bash\nuv pip install raya\n```\n\n**Or with pip:**\n```bash\npip install raya\n```\n\n## Usage\n\nTo use raya in your own script:\n```python\nfrom langchain_google_genai import ChatGoogleGenerativeAI\nfrom raya.agent import Agent\nfrom dotenv import load_dotenv\n\nload_dotenv()\nllm = ChatGoogleGenerativeAI(model='gemini-2.0-flash')\nagent = Agent(llm=llm, browser='chrome', use_vision=True)\nquery = input(\"Enter your query: \")\nresult = agent.invoke(query=query)\nprint(result.content)\n```\n\nTo run the agent from the command line:\n```bash\npython main.py\n```\n\n## Example Prompts\n\n- Write a short note about LLMs and save to the desktop\n- Change from Dark mode to Light mode\n\nSee the [demos](#) for screenshots and more examples.\n\n## Project Status\n\n- raya is under active development.\n- Contributions, bug reports, and feature requests are welcome.\n\n## Caution\n\nraya interacts directly with your windows OS at the GUI layer to perform actions. While designed to be intelligent and safe, it can make mistakes that might cause unintended changes. Use with care.\n\n## 🪪 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nThank you for your interest in contributing to raya!\n\n### Getting Started\n\n#### Development Environment\n\nraya requires:\n- Python 3.13 or later\n\n#### Installation from Source\n\n1. Fork the repository on GitHub.\n2. Clone your fork locally:\n   ```bash\n   git clone https://github.com/YOUR_USERNAME/raya.git\n   cd raya\n   ```\n3. Install the package in development mode:\n   ```bash\n   pip install -e \".[dev,search]\"\n   ```\n4. Set up pre-commit hooks:\n   ```bash\n   pip install pre-commit\n   pre-commit install\n   ```\n\n### Development Workflow\n\n#### Branching Strategy\n- `main` branch contains the latest stable code\n- Create feature branches from `main` named according to the feature you're implementing: `feature/your-feature-name`\n- For bug fixes, use: `fix/bug-description`\n\n#### Commit Messages\n- No strict style enforced, but keep commit messages clear and informational.\n\n#### Code Style\n- Uses [Ruff](https://github.com/astral-sh/ruff) for formatting and linting (see `ruff.toml`).\n- Line length: 100 characters\n- Double quotes for strings\n- PEP 8 naming conventions\n- Add type hints to function signatures\n\n#### Pre-commit Hooks\n- Configured in `.pre-commit-config.yaml`.\n- Hooks will:\n  - Format code using Ruff\n  - Run linting checks\n  - Check for trailing whitespace\n  - Ensure files end with a newline\n  - Validate YAML files\n  - Check for large files\n  - Remove debug statements\n\n### Testing\n\n#### Running Tests\nRun the test suite with pytest:\n```bash\npytest\n```\nTo run specific test categories:\n```bash\npytest tests/\n```\n\n#### Adding Tests\n- Add unit tests for new functionality in `tests/unit/`\n- For slow or network-dependent tests, mark them with `@pytest.mark.slow` or `@pytest.mark.integration`\n- Aim for high test coverage of new code\n\n### Pull Requests\n\n#### Creating a Pull Request\n1. Ensure your code passes all tests and pre-commit hooks\n2. Push your changes to your fork\n3. Submit a pull request to the main repository\n4. Follow the pull request template\n\n### Documentation\n- Update docstrings for new or modified functions, classes, and methods\n- Use Google-style docstrings:\n  ```python\n  def function_name(param1: type, param2: type) -\u003e return_type:\n      \"\"\"Short description.\n\n      Longer description if needed.\n\n      Args:\n          param1: Description of param1\n          param2: Description of param2\n\n      Returns:\n          Description of return value\n\n      Raises:\n          ExceptionType: When and why this exception is raised\n      \"\"\"\n  ```\n\n\n### Getting Help\n- Open an issue for discussion\n- Reach out to the maintainers\n- Check existing code for examples\n\n\n---\n\n## Citation\n\n```bibtex\n@software{\n  author       = {Rayamah, Ibrahim},\n  title        = {raya: Enable AI to control your PC},\n  year         = {2025},\n  publisher    = {GitHub},\n  url={https://github.com/iBz-04/raya}\n}\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibz-04%2Fraya","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibz-04%2Fraya","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibz-04%2Fraya/lists"}