{"id":35129189,"url":"https://github.com/appifyhub/the-agent","last_synced_at":"2026-04-05T02:03:15.634Z","repository":{"id":255674707,"uuid":"799169351","full_name":"appifyhub/the-agent","owner":"appifyhub","description":"The Agent's Brain","archived":false,"fork":false,"pushed_at":"2026-02-14T09:06:32.000Z","size":3777,"stargazers_count":4,"open_issues_count":10,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-14T17:40:35.534Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://agent.appifyhub.com","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/appifyhub.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":"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":"2024-05-11T11:06:48.000Z","updated_at":"2026-02-08T16:11:40.000Z","dependencies_parsed_at":"2024-09-06T17:29:24.506Z","dependency_job_id":"c1ceb0fb-bfe2-4fa6-bb53-26c759b435e9","html_url":"https://github.com/appifyhub/the-agent","commit_stats":null,"previous_names":["appifyhub/the-agent"],"tags_count":273,"template":false,"template_full_name":null,"purl":"pkg:github/appifyhub/the-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appifyhub%2Fthe-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appifyhub%2Fthe-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appifyhub%2Fthe-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appifyhub%2Fthe-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appifyhub","download_url":"https://codeload.github.com/appifyhub/the-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appifyhub%2Fthe-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29601571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T02:50:40.506Z","status":"ssl_error","status_checked_at":"2026-02-19T02:50:26.316Z","response_time":117,"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":[],"created_at":"2025-12-28T04:31:51.257Z","updated_at":"2026-03-05T20:28:58.747Z","avatar_url":"https://github.com/appifyhub.png","language":"Python","readme":"![License](https://img.shields.io/github/license/appifyhub/the-agent?logo=github\u0026logoColor=white\u0026label=License\u0026color=FA3080)\n![Date](https://img.shields.io/github/release-date/appifyhub/the-agent?display_date=published_at\u0026logo=docker\u0026logoColor=white\u0026label=Released\u0026color=FA3080)\n![Release](https://img.shields.io/github/v/release/appifyhub/the-agent?sort=semver\u0026display_name=release\u0026logo=github\u0026logoColor=white\u0026label=Latest\u0026color=FA3080)  \n![Code](https://img.shields.io/github/repo-size/appifyhub/the-agent?logo=github\u0026logoColor=white\u0026label=Sources\u0026color=FAFA20)\n![Image](https://img.shields.io/docker/image-size/appifyhub/the-agent?sort=semver\u0026logo=docker\u0026logoColor=white\u0026label=Image\u0026color=FAFA20)  \n![Build](https://img.shields.io/github/actions/workflow/status/appifyhub/the-agent/release.yml?branch=release\u0026logo=github\u0026logoColor=white\u0026label=Build)\n![Issues](https://img.shields.io/github/issues-closed/appifyhub/the-agent?logo=github\u0026logoColor=white\u0026label=Issues\u0026color=blue)\n![PRs](https://img.shields.io/github/issues-pr-closed/appifyhub/the-agent?logo=github\u0026logoColor=white\u0026label=PRs\u0026color=blue)\n\n# The Agent · Our Intelligent Virtual Assistant\n\n## About the project\n\nThis repository contains the **complete** codebase of The Agent's backend service.\n\nThe service covers for the majority of daily user-facing features, such as asking for advice, checking news, analyzing photos, generating new content, etc. Although the final product looks like a simple wrapper around the Large Language Model (LLM) technology, it's more than that – The Agent is a complex system or interconnected modules that integrate many services and APIs, and enables multiple access channels to provide a true virtual assistant experience.\n\nSee the rest of this document for a developer's overview and information on how to use it yourself.\n\n#### Access\n\nThis service currently powers several production-level bots. For privacy reasons, we're not listing each bot here individually – but you can definitely run the service locally on your machine (for free) and connect it to your own bot. You're also welcome to use the service as a standalone backend for your own projects, assuming you have the necessary infrastructure to host it.\n\n## Before you continue…\n\nIf you plan on contributing to this project in any way, please read and acknowledge the [Contributing guide](./CONTRIBUTING.md) first.\n\nPlease also take note of the [License](./LICENSE).\n\n## Developer's Overview\n\nBecause the complete codebase is open-source, you can inspect and run the service yourself.\n\n### Tech Stack\n\nThe project currently uses the following tech stack:\n\n- Runtime: **Python**\n- Language: **Python**\n- Framework: **FastAPI** (with Pydantic 2)\n- Persistence: **PostgreSQL** (with SQL Alchemy)\n- Build System: **Pipenv** \u0026 **Custom** (see `tools` and `.github` directories)\n- Continuous Integration: **GitHub Actions**\n- Continuous Deployment: **Argo CD**\n- Distribution: **Docker** image (managed deployment on Kubernetes)\n\n### How to build and run?\n\n#### Dependencies\n\n\u003e ℹ️  This project uses `pipenv` to manage dependencies and take care of the environment.\n\nUsing `pipenv`, you can run `pipenv install` in the root directory to set up your dependencies correctly.\n\nTo prepare the production server (less logging, more parallelism):\n\n```bash\npipenv install\n```\n\nTo prepare a development system, e.g. for testing and improvement purposes:\n\n```bash\n# Install the project's development dependencies\npipenv install --dev\n\n# Install git hooks for pre-commit checks\npipenv run pre-commit install --install-hooks\n```\n\nAfter the dependencies have been installed, you can run `pipenv shell` to get a new shell forked, in which the environment will be set up to easily run everything. Your Python version will be correct in there, and the dependencies will be available.\n\nPre-commit installation sets up a git hook to validate code quality before every commit.\n\n\u003e ℹ️  To exit the shell, simply run `deactivate`, followed by `exit` (if the shell hasn't closed automatically).\n\nExiting the shell will disconnect the dev environment from your shell session, so you will need to run `pipenv shell` again to get back into the correct environment.\n\nOnce the environment has been configured, you can run the main code.\n\n#### Running tools\n\nYou can use the pre-built scripts located in the `tools` directory. Those are easy-to-use, single-shot Shell executables that require no developer setup.\n\nTo install dependencies and run the service in production mode:\n\n```bash\npipenv install\npipenv run python src/main.py\n```\n\nTo install dependencies and run the service in development mode:\n\n```bash\npipenv install --dev\npipenv run python src/main.py --dev\n```\n\nTo run lint checks and auto-fix them:\n\n```bash\n# Run the lint checks on *all* files\npipenv run pre-commit run --all-files --show-diff-on-failure\n\n# Run the lint checks only on *git-staged* files\npipenv run pre-commit run\n```\n\nAnd most importantly, to run all tests:\n\n```bash\npipenv run pytest -v\n```\n\n\u003e ℹ️  Follow the command line instructions for more information during the execution of the scripts.\n\nThere are more tools in the same directory (especially useful around database migrations); feel free to explore those at your own pace when needed.\n\nTo emulate this behavior on Windows, you would need to inspect the scripts individually and mimic their behavior in the DOS environment... or open a Pull Request with a Windows-compatible version of the scripts!\n\n#### Docker support\n\nThis final product is also available as a **Docker** image.  \nFor more information on how to run it using Docker, see the `Dockerfile` and the `Packages` section in the GitHub repository. There's also more information in the [Docker directory](./docker).\n\n### License\n\nCheck out the license [here](LICENSE).\n\n---\n\nFor frontend and user interface details, see the [web app repository](https://github.com/appifyhub/the-agent-web-app).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappifyhub%2Fthe-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappifyhub%2Fthe-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappifyhub%2Fthe-agent/lists"}