{"id":27968635,"url":"https://github.com/nethermindeth/agent4rena-agent-template","last_synced_at":"2025-05-07T21:05:48.859Z","repository":{"id":284539944,"uuid":"955266115","full_name":"NethermindEth/Agent4rena-agent-template","owner":"NethermindEth","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-07T19:18:51.000Z","size":55,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-07T21:05:44.119Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/NethermindEth.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":"2025-03-26T11:24:53.000Z","updated_at":"2025-05-05T07:59:29.000Z","dependencies_parsed_at":"2025-04-30T17:20:46.547Z","dependency_job_id":"aea97e02-0d31-451c-b86e-382c965f92cb","html_url":"https://github.com/NethermindEth/Agent4rena-agent-template","commit_stats":null,"previous_names":["nethermindeth/agent4rena-agent-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NethermindEth%2FAgent4rena-agent-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NethermindEth%2FAgent4rena-agent-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NethermindEth%2FAgent4rena-agent-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NethermindEth%2FAgent4rena-agent-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NethermindEth","download_url":"https://codeload.github.com/NethermindEth/Agent4rena-agent-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252954428,"owners_count":21830903,"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":[],"created_at":"2025-05-07T21:05:48.310Z","updated_at":"2025-05-07T21:05:48.845Z","avatar_url":"https://github.com/NethermindEth.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Solidity Audit Agent Template\n\nAn AI-powered agent template for auditing Solidity smart contracts using OpenAI models.\n\n## Features\n\n- Audit Solidity contracts for security vulnerabilities\n- Security findings classified by threat level (Critical, High, Medium, Low, Informational)\n- Two operation modes:\n  - **Server mode**: Runs a webhook server to receive notifications from Agent4rena when a new challenge begins\n  - **Local mode**: Processes a GitHub repository directly\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/solidity-audit-agent.git\ncd solidity-audit-agent\n\n# Create a virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install the package\npip install -e .\n\n# Create .env file from example\ncp .env.example .env\n# Edit .env with your configuration\n```\n\n## Configuration\n\nCreate a `.env` file from `.env.example` and set the variables.\n\n```\ncp .env.example .env\n```\n\n## Usage\n\n### Server Mode\n\n#### ⚠️ Warning ⚠️ - This mode does not work yet. It will be available once Agent4rena is released.\n\nJoin the [telegram group](https://t.me/agent4rena) to stay updated with the latest news.\n\nTo run the agent in server mode, you need to run the following command:\n\n```bash\naudit-agent server\n```\n\nBy default, the agent will run on port 8000. To use a custom port, you can use the following command:\n\n```bash\naudit-agent server --port 8008\n```\n\n### Local Mode\n\nRun the agent in local mode to audit a GitHub repository directly.\n\nYou can use the following example repository to test out the agent. The results will be saved in JSON format in the specified output file, by default that is `audit.json`.\n\n```bash\naudit-agent local --repo https://github.com/andreitoma8/learn-solidity-hacks.git --output audit.json\n```\n\nThis mode is useful for testing the agent or auditing repositories outside of the Agent4rena platform.\n\nTo see all available options (such as auditing a specific commit or selecting only some of the files to audit), run\n\n```bash\naudit-agent --help\n```\n\n## License\n\nMIT \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnethermindeth%2Fagent4rena-agent-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnethermindeth%2Fagent4rena-agent-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnethermindeth%2Fagent4rena-agent-template/lists"}