{"id":18789124,"url":"https://github.com/hmasdev/runnable_family","last_synced_at":"2025-12-25T23:30:12.485Z","repository":{"id":232405469,"uuid":"782530183","full_name":"hmasdev/runnable_family","owner":"hmasdev","description":"A python library implementing a family of Runnables in langchain","archived":false,"fork":false,"pushed_at":"2024-09-14T14:56:10.000Z","size":68,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-29T14:34:50.622Z","etag":null,"topics":["langchain","llm","python","runnable"],"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/hmasdev.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}},"created_at":"2024-04-05T13:31:54.000Z","updated_at":"2024-09-14T14:56:07.000Z","dependencies_parsed_at":"2024-04-09T18:07:55.108Z","dependency_job_id":"5c44460f-9366-4114-ad97-19f46a02b542","html_url":"https://github.com/hmasdev/runnable_family","commit_stats":null,"previous_names":["hmasdev/runnable_family"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmasdev%2Frunnable_family","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmasdev%2Frunnable_family/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmasdev%2Frunnable_family/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmasdev%2Frunnable_family/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hmasdev","download_url":"https://codeload.github.com/hmasdev/runnable_family/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239709191,"owners_count":19684212,"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","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":["langchain","llm","python","runnable"],"created_at":"2024-11-07T21:06:46.652Z","updated_at":"2025-12-25T23:30:12.454Z","avatar_url":"https://github.com/hmasdev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Runnable Family\n\n![GitHub top language](https://img.shields.io/github/languages/top/hmasdev/runnable_family)\n![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/hmasdev/runnable_family?sort=semver)\n![GitHub](https://img.shields.io/github/license/hmasdev/runnable_family)\n![GitHub last commit](https://img.shields.io/github/last-commit/hmasdev/runnable_family)\n\n![Scheduled Test](https://github.com/hmasdev/runnable_family/actions/workflows/tests-on-schedule.yaml/badge.svg)\n\nA python library implementing a family of Runnables in langchain like loopback, self-consistent, self-refine, and self-translate.\n\n## Requirements\n\n- Python 3.10 or higher\n\nSee the [pyproject.toml](./pyproject.toml) file for the required packages.\n\n## Installation\n\nFirst, you should create a virtual environment before installing the package.\n\n- On Unix or MacOS:\n\n  ```bash\n  python -m venv venv\n  source venv/bin/activate\n  ```\n\n- On Windows:\n\n  ```bash\n  python -m venv venv\n  venv\\Scripts\\activate\n  ```\n\nAfter creating the virtual environment, you can install the package using pip:\n\n```bash\npip install git+https://github.com/hmasdev/runnable_family\n```\n\nor you can clone the repository and install the package using pip:\n\n```bash\ngit clone https://github.com/hmasdev/runnable_family\ncd runnable_family\npip install .\n```\n\n## Usage\n\nJust import your favorite classes.\n\n```python\nfrom runnable_family.basic import RunnableConstant, RunnableAdd, RunnablePartialLambda, RunnableLog\nfrom runnable_family.loopback import RunnableLoopback\nfrom runnable_family.gacha import RunnableGacha\nfrom runnable_family.random import RunnableRandomBranch\nfrom runnable_family.runnable_diff import RunnableDiff\nfrom runnable_family.self_consistent import RunnableSelfConsistent\nfrom runnable_family.self_refine import RunnableSelfRefine\nfrom runnable_family.self_translate import RunnableSelfTranslate\n```\n\nThey are inherited from the Runnable class, so you can use them as a Runnable, that is, you can use them as chain components.\n\nSee [basic-examples.ipynb](./examples/basic-examples.ipynb) to see how to use them.\n\n## Development\n\n1. Fork the repository: [https://github.com/hmasdev/runnable_family](https://github.com/hmasdev/runnable_family)\n2. Clone the repository\n\n   ```bash\n   git clone https://github.com/{YOURE_NAME}/runnable_family\n   cd runnable_family\n   ```\n\n3. Create a virtual environment\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate\n   ```\n\n4. Install the required packages\n\n   ```bash\n   pip install -e .[dev]\n   ```\n\n5. Checkout your working branch\n\n   ```bash\n   git checkout -b your-working-branch\n   ```\n\n6. Make your changes\n\n7. Test your changes\n\n   ```bash\n   pytest\n   flake8 runnable_family tests\n   mypy runnable_family tests\n   ```\n\n8. Commit your changes\n\n   ```bash\n   git add .\n   git commit -m \"Your commit message\"\n   ```\n\n9. Push your changes\n\n   ```bash\n   git push origin your-working-branch\n   ```\n\n10. Create a pull request: [https://github.com/hmasdev/runnable_family/compare](https://github.com/hmasdev/runnable_family/compare)\n\n## License\n\n[MIT](LICENSE)\n\n## Author\n\n[hmasdev](https://github.com/hmasdev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmasdev%2Frunnable_family","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmasdev%2Frunnable_family","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmasdev%2Frunnable_family/lists"}