{"id":22843647,"url":"https://github.com/aeksco/agentql-docker-example","last_synced_at":"2026-01-23T22:15:19.898Z","repository":{"id":264490858,"uuid":"868948271","full_name":"aeksco/agentql-docker-example","owner":"aeksco","description":"Example project for running the AgentQL Python SDK in a Docker container, using MongoDB for storing inputs and outputs.","archived":false,"fork":false,"pushed_at":"2024-10-07T13:15:57.000Z","size":14,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-23T00:57:17.153Z","etag":null,"topics":["agentql","docker","docker-compose","example","mongo-express","mongodb"],"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/aeksco.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}},"created_at":"2024-10-07T13:12:03.000Z","updated_at":"2024-11-18T09:12:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"0e1c2550-8798-4220-bbc9-f4daaaaffc46","html_url":"https://github.com/aeksco/agentql-docker-example","commit_stats":null,"previous_names":["aeksco/agentql-docker-example"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aeksco/agentql-docker-example","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeksco%2Fagentql-docker-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeksco%2Fagentql-docker-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeksco%2Fagentql-docker-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeksco%2Fagentql-docker-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aeksco","download_url":"https://codeload.github.com/aeksco/agentql-docker-example/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aeksco%2Fagentql-docker-example/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28701276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"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":["agentql","docker","docker-compose","example","mongo-express","mongodb"],"created_at":"2024-12-13T02:16:52.829Z","updated_at":"2026-01-23T22:15:19.894Z","avatar_url":"https://github.com/aeksco.png","language":"Python","readme":"# AgentQL Python SDK Docker Example\n\nThis project demonstrates how to run the [AgentQL](https://www.agentql.com/) Python SDK in a Docker container, using MongoDB for storing basic inputs and outputs. It showcases the power of AgentQL for painless data extraction and web automation.\n\n## Table of Contents\n\n1. [Project Overview](#project-overview)\n2. [What is AgentQL?](#what-is-agentql)\n3. [Project Structure](#project-structure)\n4. [Prerequisites](#prerequisites)\n5. [Getting Started](#getting-started)\n6. [Services](#services)\n7. [Environment Variables](#environment-variables)\n8. [API Endpoints](#api-endpoints)\n9. [Additional Resources](#additional-resources)\n\n## Project Overview\n\n- **Main Application**: Runs the AgentQL Python SDK\n- **Database**: MongoDB for storing inputs and outputs\n- **Admin Interface**: MongoDB Express for database management\n\n## What is AgentQL?\n\nAgentQL is an AI-powered tool that allows you to extract data and automate web interactions using natural language queries instead of fragile XPath or DOM selectors. It's designed to be robust, adapting to changes in website structures automatically.\n\nKey features of AgentQL include:\n\n- Semantic selectors\n- Natural language queries\n- Controlled output\n- Deterministic results\n\n## Project Structure\n\nThe project uses Docker Compose to orchestrate the following services:\n\n1. `app`: The main application service running AgentQL Python SDK\n2. `mongodb`: The MongoDB database service\n3. `mongo-express`: A web-based MongoDB admin interface\n\n## Prerequisites\n\n- Docker\n- Docker Compose\n\n## Getting Started\n\n1. Clone the repository:\n\n   ```\n   git clone \u003crepository-url\u003e\n   cd \u003cproject-directory\u003e\n   ```\n\n2. Set up environment variables:\n\n   ```\n   cp .env.example .env\n   ```\n\n   Open the `.env` file and update the `AGENTQL_API_KEY` with your own API key:\n\n   ```\n   AGENTQL_API_KEY=your_actual_api_key_here\n   ```\n\n3. Build and start the services:\n\n   ```\n   docker-compose up\n   ```\n\n4. Access the application at `http://localhost:8000`\n\n5. Access the MongoDB Express admin interface at `http://localhost:8081`\n   - Username: `admin`\n   - Password: `pass`\n\n## Services\n\n### App\n\n- Built from the Dockerfile in the project root\n- Runs the AgentQL Python SDK\n- Source code is mounted from `./app` directory\n- Runs on port 8000\n\n### MongoDB\n\n- Uses the latest MongoDB image\n- Stores basic inputs and outputs from the AgentQL SDK\n- Data is persisted in a named volume `mongodb_data`\n- Runs on port 27017\n\n### Mongo Express\n\n- Web-based MongoDB admin interface\n- Runs on port 8081\n- Default login credentials:\n  - Username: `admin`\n  - Password: `pass`\n\n## Environment Variables\n\nThe project uses a `.env` file for configuration. Make sure the following variables are set up:\n\n- `AGENTQL_API_KEY`: Your AgentQL API key\n- `MONGODB_URI`: Set automatically in the docker-compose file\n- Add any additional AgentQL SDK specific environment variables\n\n**Remember to never commit your `.env` file with sensitive information to version control.**\n\n## API Endpoints\n\n### /ingest\n\n- Method: POST\n- Description: Ingests a URL for processing\n- Request body:\n\n```\ncurl --location 'localhost:8000/ingest' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"url\": \"https://centrifuge.mirror.xyz/wQGnnIo89V0C1jIWvUcGGEQixrou5BjcZijjxQPNBlo\"\n}'\n```\n\n`/process` endpoint:\n\n```\ncurl --location 'localhost:8000/process'\n```\n\n## Additional Resources\n\n- [AgentQL Documentation](https://docs.agentql.com/)\n- [AgentQL Python SDK](https://github.com/agentql/agentql-python)\n\n## License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for more details.\n\nBuilt with :heart: by [aeksco](https://twitter.com/aeksco)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faeksco%2Fagentql-docker-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faeksco%2Fagentql-docker-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faeksco%2Fagentql-docker-example/lists"}