{"id":30250333,"url":"https://github.com/soorya-u/votex","last_synced_at":"2026-04-13T19:31:10.559Z","repository":{"id":248110533,"uuid":"827475661","full_name":"soorya-u/VoteX","owner":"soorya-u","description":"An AI driven Stellar based Decentralized Voting Application which empowers communities to make decisions collectively with confidence.","archived":false,"fork":false,"pushed_at":"2025-09-07T17:06:44.000Z","size":33526,"stargazers_count":0,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-08T07:12:28.594Z","etag":null,"topics":["blockchain","fastapi","nextjs","python","react","redis","rust","soroban","stellar","tailwindcss","twilio","typescript","web3"],"latest_commit_sha":null,"homepage":"https://votex.soorya-u.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soorya-u.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-07-11T18:06:54.000Z","updated_at":"2025-09-07T16:53:26.000Z","dependencies_parsed_at":"2025-01-14T17:48:28.320Z","dependency_job_id":"8ca7703d-6991-4db8-88ef-875f096c1648","html_url":"https://github.com/soorya-u/VoteX","commit_stats":null,"previous_names":["soorya-u/democrachain","soorya-u/votex"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/soorya-u/VoteX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soorya-u%2FVoteX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soorya-u%2FVoteX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soorya-u%2FVoteX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soorya-u%2FVoteX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soorya-u","download_url":"https://codeload.github.com/soorya-u/VoteX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soorya-u%2FVoteX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31768635,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","response_time":93,"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":["blockchain","fastapi","nextjs","python","react","redis","rust","soroban","stellar","tailwindcss","twilio","typescript","web3"],"created_at":"2025-08-15T09:36:33.423Z","updated_at":"2026-04-13T19:31:10.540Z","avatar_url":"https://github.com/soorya-u.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://votex.soorya-u.dev/logo.webp\" alt=\"Logo\" width=\"120\" height=\"120\"\u003e\n\n  \u003ch1 align=\"center\"\u003eVoteX\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    An AI driven Stellar based Decentralized Voting Application which empowers communities to make decisions collectively with confidence.\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://votex.soorya-u.dev\"\u003eView Demo\u003c/a\u003e\n    \u003cstrong\u003e\u0026middot;\u003c/strong\u003e\n    \u003ca href=\"https://github.com/soorya-u/VoteX/issues\"\u003eReport Bug\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## About The Project\n\nThis project is a secure, AI-driven, decentralized voting application built on the Stellar blockchain with Soroban smart contracts to ensure transparency and immutability. The system leverages Next.js for the frontend, a Python-based proxy server, and Redis as the database.\n\n### Key Features\n\n- Decentralized \u0026 Secure – Built on Stellar blockchain with Soroban smart contracts for transparent voting.\n- AI-Powered Authentication – Uses OCR for Aadhaar card recognition and face recognition models for enhanced security.\n- Fast \u0026 Scalable – A Python proxy server optimizes API calls, and Redis ensures quick data access.\n- User-Friendly Interface – A seamless Next.js frontend for an intuitive voting experience.\n\nThis system guarantees secure, verifiable, and tamper-proof elections with the power of AI and blockchain.\n\n### Built With\n\n#### Client\n\n[![Typescript][typescript-badge]][typescript-url]\n[![Next][nextjs-badge]][nextjs-url]\n[![Tailwind][tailwind-badge]][tailwind-url]\n\n#### Server\n\n[![Python][python-badge]][python-url]\n[![FastAPI][fastapi-badge]][fastapi-url]\n\n#### Database \u0026 Services\n\n[![Redis][redis-badge]][redis-url]\n[![Twilio][twilio-badge]][twilio-url]\n\n#### Web3\n\n[![Rust][rust-badge]][rust-url]\n[![Stellar][stellar-badge]][stellar-url]\n[![Pinata][pinata-badge]][pinata-url]\n\n## Architecture\n\n\u003cpicture\u003e\n  \u003csource srcset=\"https://votex.soorya-u.dev/architecture-dark.png\" media=\"(prefers-color-scheme: dark)\" style=\"filter: invert(1);\" /\u003e\n  \u003cimg src=\"https://votex.soorya-u.dev/architecture-light.png\" alt=\"architecture\" align=\"center\" style=\"filter: invert(0);\" /\u003e\n\u003c/picture\u003e\n\n## Getting Started\n\nThis is a set of instructions on how to set up your project locally.\nTo get a local copy up and running follow these simple example steps.\n\n### Prerequisites\n\nThese are the softwares required to run the project.\n\n#### Local Prerequisites\n\n- [Node.js](https://nodejs.org/en/download)\n- [Python](https://www.python.org/downloads/release/python-3124/)\n- [Rust](https://www.rust-lang.org/tools/install)\n- [Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/archive/install-redis/)\n\n#### Docker Prerequisites\n\n- [Docker](https://docs.docker.com/get-started/get-docker/)\n\n### Installation\n\n#### Run Docker\n\n1. Clone the repository\n\n   ```sh\n   git clone https://github.com/soorya-u/votex.git\n   ```\n\n2. Install [Stellar CLI](https://developers.stellar.org/docs/tools/cli/install-cli)\n\n3. Start the Stellar Service\n\n   ```\n   docker compose up stellar --build\n   ```\n\n4. Create a new Local Network\n\n   ```sh\n   stellar network add \u003cnetwork-name\u003e --rpc-url \u003crpc-url\u003e --network-passphrase \u003cpassphase\u003e\n   # for local network, rpc-url: `http://localhost:8000/soroban/rpc` and passphase: `\"Standalone Network ; February 2017\"`\n   ```\n\n   - To check the health of Stellar, run\n\n     ```sh\n     docker exec votex-stellar /opt/stellar/bin/health-check.sh\n     ```\n\n   - To check the running processes in Stellar, run\n\n     ```sh\n     docker exec votex-stellar supervisorctl status\n     ```\n\n   - If any of the process is not running, run\n\n     ```sh\n     docker exec votex-stellar supervisorctl start \u003cprocess-name\u003e[friendbot, postgresql, ...]\n     ```\n\n5. Create a new Account using Stellar CLI\n\n   ```sh\n   stellar keys generate \u003cyour-username\u003e --network \u003cnetwork-name\u003e --fund\n   ```\n\n6. Connect to Freighter Wallet by importing the account using the secret key\n\n   ```sh\n   stellar keys show \u003cyour-username\u003e\n   ```\n\n7. Navigate to _web3_ Directory\n\n   ```sh\n   cd web3\n   ```\n\n8. Run the Deploy Command with Username and Network Options as Parameters to get the Deployed Contract Address\n\n   ```ps1\n   .\\scripts\\deploy.ps1 -Source \u003cyour-username\u003e -Network \u003cyour-network\u003e\n   ```\n\n   ```sh\n   ./scripts/deploy.sh SOURCE=\u003cyour-username\u003e NETWORK=\u003cyour-network\u003e\n   ```\n\n9. Create `.env` at the root of the project and fill the required variables\n\n   ```sh\n   # root .env\n   cp .env.example .env\n   ```\n\n10. Navigate to Client\n\n    ```sh\n    cd client\n    ```\n\n11. Create `.env` and fill the required variables\n\n    ```sh\n    cp .env.example .env.docker\n    ```\n\n12. Navigate to Server\n\n    ```sh\n    cd server\n    ```\n\n13. Create `.env` and fill the required variables\n\n    ```sh\n    cp .env.example .env.docker\n    ```\n\n14. Run the Client and Server Docker Images\n\n```sh\n# Starts up redis as well\ndocker compose up client server --build\n```\n\n#### Run Locally\n\n1. Clone the repository\n\n   ```sh\n   git clone https://github.com/soorya-u/votex.git\n   ```\n\n2. Install [Stellar CLI](https://developers.stellar.org/docs/tools/cli/install-cli)\n\n3. Create a new Account using Stellar CLI\n\n   ```\n   stellar keys generate \u003cname\u003e --network testnet --fund\n   ```\n\n4. Navigate to _web3_ Directory\n\n   ```sh\n   cd web3\n   ```\n\n5. Run the Deploy Command with Username and Network Options as Parameters to get the Deployed Contract Address\n\n   ```ps1\n   .\\scripts\\deploy.ps1 -Source \u003cyour-username\u003e -Network testnet\n   ```\n\n   ```sh\n   ./scripts/deploy.sh SOURCE=\u003cyour-username\u003e NETWORK=testnet\n   ```\n\n6. Connect to Freighter Wallet by importing the account using the secrets\n\n   ```sh\n   stellar keys show \u003cyour-username\u003e\n   ```\n\n7. Retrieve API Keys from Pinata and Twilio\n\n8. Navigate to Server\n\n   ```sh\n   cd server\n   ```\n\n9. Create `.env` and fill the required variables\n\n   ```sh\n   cp .env.example .env\n   ```\n\n10. Install all the required packages\n\n    ```sh\n    poetry install\n    ```\n\n11. Run the FastAPI Server\n\n    ```sh\n    poetry run fastapi dev src\n    ```\n\n12. Navigate to Client\n\n    ```sh\n    cd client\n    ```\n\n13. Create `.env` and fill the required variables\n\n    ```sh\n    cp .env.example .env\n    ```\n\n14. Install Dependencies\n\n    ```sh\n    bun install\n    ```\n\n15. Run the Development Server\n    ```sh\n    bun dev\n    ```\n\n## Roadmap\n\n- [ ] Rasa Chatbot Integration\n\nSee the [open issues](https://github.com/soorya-u/votex/issues) for a full list of proposed features (and known issues).\n\n[typescript-badge]: https://img.shields.io/badge/Typescript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\n[typescript-url]: https://www.typescriptlang.org/\n[nextjs-badge]: https://img.shields.io/badge/Next.js-000000?style=for-the-badge\u0026logo=nextdotjs\u0026logoColor=white\n[nextjs-url]: https://nextjs.org/\n[tailwind-badge]: https://img.shields.io/badge/TailwindCSS-06B6D4?style=for-the-badge\u0026logo=tailwindcss\u0026logoColor=white\n[tailwind-url]: https://tailwindcss.com/\n[python-badge]: https://img.shields.io/badge/Python-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white\n[python-url]: https://python.org/\n[fastapi-badge]: https://img.shields.io/badge/FastAPI-009688?style=for-the-badge\u0026logo=fastapi\u0026logoColor=white\n[fastapi-url]: https://fastapi.tiangolo.com/\n[redis-badge]: https://img.shields.io/badge/Redis-FF4438?style=for-the-badge\u0026logo=redis\u0026logoColor=white\n[redis-url]: https://redis.io/\n[twilio-badge]: https://img.shields.io/badge/Twilio-F22F46?style=for-the-badge\u0026logo=twilio\u0026logoColor=white\n[twilio-url]: https://www.twilio.com/\n[rust-badge]: https://img.shields.io/badge/Rust-B6400E?style=for-the-badge\u0026logo=rust\u0026logoColor=white\n[rust-url]: https://www.rust-lang.org/\n[stellar-badge]: https://img.shields.io/badge/Stellar-000000?style=for-the-badge\u0026logo=stellar\u0026logoColor=white\n[stellar-url]: https://stellar.org/\n[pinata-badge]: https://img.shields.io/badge/Pinata-6D3AC6?style=for-the-badge\u0026logo=pinboard\u0026logoColor=white\n[pinata-url]: https://pinata.cloud/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoorya-u%2Fvotex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoorya-u%2Fvotex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoorya-u%2Fvotex/lists"}