orga es un bot de Telegram para administrar organizaciones, asociaciones civiles y grupos políticos. Permite crear encuestas, elecciones, manejar un estatuto, colectas de fondos y más.
Las principales funcionalidades que incluye actualmente son:
- Verificación con NFT: Requiere que los miembros verifiquen la propiedad de un NFT específico para unirse al grupo.
- Encuestas: Permite crear encuestas con opción de múltiple respuesta y voto secreto. Las encuestas tienen un periodo de creación y votación.
- Estatuto: Maneja el estatuto de la organización como una serie de artículos que pueden crearse y modificarse a través de votación.
- Elecciones: Permite crear elecciones para cargos y órganos de gobierno. Usando los periodos de votación.
- Colectas: Permite realizar colectas de fondos con criptomonedas sobre zkSync de forma transparente.
- Llamadas grupales: Da la capacidad de agendar llamadas de audio privadas (Telegram) y públicas (Twitter Space).
Orgabot utiliza las siguientes tecnologías y librerías de Python:
- python-telegram-bot - Para interactuar con la API de Telegram
- tweepy - Para interactuar con la API de Twitter
- web3.py - Para verificar la propiedad de NFT sobre Ethereum
- zksync2 - Para manejar pagos con zkSync
- pyyaml - Para leer archivos de configuración
- sqlite3 - Como base de datos para persistir información
- Clona este repositorio
- Crea un entorno virtual Python
- Instala las dependencias (
pip install -r requirements.txt
) - Completa la configuración
- Ejecuta
python bot.py
La configuración se lee desde archivos YAML:
config.yaml
: Configuración general del bot.estatuto.yaml
: Artículos del estatuto.abi.json
: ABI para verificar NFT.
Los parámetros a completar incluyen:
- Tokens de API para Telegram y Twitter
- URLs de los nodos de Ethereum y zkSync
- Dirección del contrato NFT
- Billeteras para las colectas
GPL-3.0 license.