{"id":28092554,"url":"https://github.com/venopyx/pyvuebot","last_synced_at":"2025-05-13T13:19:58.826Z","repository":{"id":285307174,"uuid":"957678050","full_name":"venopyX/pyvuebot","owner":"venopyX","description":"A modern CLI tool for creating and managing Telegram Mini Apps with Vue.js and FastAPI.","archived":false,"fork":false,"pushed_at":"2025-03-31T08:04:46.000Z","size":319,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T13:19:53.016Z","etag":null,"topics":["bot","fastapi","library","mini-app","package","pip","pypi","python","pyvuebot","supabase","telegram","telegram-mini-app","vuejs"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/pyvuebot","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/venopyX.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}},"created_at":"2025-03-30T23:30:17.000Z","updated_at":"2025-03-31T12:29:07.000Z","dependencies_parsed_at":"2025-03-31T00:34:07.151Z","dependency_job_id":null,"html_url":"https://github.com/venopyX/pyvuebot","commit_stats":null,"previous_names":["venopyx/pyvuebot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venopyX%2Fpyvuebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venopyX%2Fpyvuebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venopyX%2Fpyvuebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/venopyX%2Fpyvuebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/venopyX","download_url":"https://codeload.github.com/venopyX/pyvuebot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253948512,"owners_count":21988962,"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":["bot","fastapi","library","mini-app","package","pip","pypi","python","pyvuebot","supabase","telegram","telegram-mini-app","vuejs"],"created_at":"2025-05-13T13:19:58.035Z","updated_at":"2025-05-13T13:19:58.817Z","avatar_url":"https://github.com/venopyX.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PyVueBot\n\n\u003cimg src=\"https://raw.githubusercontent.com/venopyX/pyvuebot/refs/heads/main/pyvuebot.png\" alt=\"PyVueBot Logo\" style=\"max-height: 300px;\"/\u003e\n\nA modern CLI tool for creating and managing Telegram Mini Apps with Vue.js and FastAPI.\n\n## Overview\n\nPyVueBot streamlines the development of Telegram Mini Apps by providing:\n\n- Project scaffolding from templates with variable substitution\n- Interactive setup wizard for easy configuration\n- Development server with hot reloading\n- Production builds and deployment\n- Integrated Telegram webhook management\n- Vercel deployment support\n\n---\n\n## Installation\n\n```bash\npip install pyvuebot\n```\n\n## Quick Start\n\n1. Create a new project:\n\n```bash\npyvuebot init my-telegram-app\n```\n\n2. Install dependencies:\n\n```bash\ncd my-telegram-app\npyvuebot install\n```\n\n3. Start development:\n\n```bash\npyvuebot dev\n```\n\n4. Configure your webhook:\n\n```bash\npyvuebot webhook set\n```\n\n5. Build and deploy:\n\n```bash\npyvuebot build\npyvuebot deploy\n```\n\n---\n\n## Command Reference\n\n### Project Management\n\n- `pyvuebot init [NAME]` - Create a new project\n\n  - `--template` - Specify a template (default: task_manager)\n  - `--description` - Project description\n  - `--yes, -y` - Skip interactive prompts and use defaults\n  - `--force, -f` - Override existing directory\n\n- `pyvuebot install` - Install dependencies\n- `pyvuebot dev` - Start development servers\n- `pyvuebot build` - Build for production\n- `pyvuebot deploy` - Deploy to Vercel\n\n### Webhook Management\n\n- `pyvuebot webhook set` - Set up a Telegram bot webhook\n\n  - `--token` - Telegram bot token\n  - `--url` - Web app URL\n  - `--path` - Custom webhook path\n\n- `pyvuebot webhook info` - Check webhook status\n\n  - `--token` - Telegram bot token\n\n- `pyvuebot webhook delete` - Delete webhook\n  - `--token` - Telegram bot token\n  - `--drop-pending` - Drop pending updates\n\n---\n\n## Templates\n\nCurrently available templates:\n\n- `task_manager` - Full-stack task management app (default)\n- More coming soon...\n\n## Project Structure\n\n```\nmy-telegram-app/\n├── api/                    # FastAPI backend\n│   ├── routes/             # API endpoints\n│   ├── models.py           # Data models\n│   └── db.py               # Database setup\n├── src/                    # Vue.js frontend\n│   ├── components/         # Vue components\n│   ├── services/           # API services\n│   └── store/              # State management\n├── index.html              # HTML entry point\n├── package.json            # Node dependencies\n├── requirements.txt        # Python dependencies\n├── .env                    # Environment variables\n├── .env.example            # Environment variables template\n├── vercel.json             # Vercel configuration\n└── pyvuebot.json           # Project configuration\n```\n\n---\n\n## Configuration\n\nThe `pyvuebot.json` file contains project configuration:\n\n```json\n{\n  \"name\": \"my-telegram-app\",\n  \"template\": \"task_manager\",\n  \"description\": \"My Telegram Mini App\",\n  \"version\": \"0.1.0\",\n  \"created_at\": \"2023-03-31T01:53:14.539642\"\n}\n```\n\n## Dynamic Template Variables\n\nTemplates can use variables in the format `{{ variable_name }}` which will be replaced during project creation:\n\n- `{{ project_name }}` - Project name\n- `{{ project_description }}` - Project description\n- `{{ creation_date }}` - Creation date (YYYY-MM-DD)\n- `{{ creation_year }}` - Creation year\n- `{{ template_name }}` - Template name\n\n## Environment Variables\n\nRequired environment variables:\n\n- `TELEGRAM_BOT_TOKEN` - Your Telegram bot token\n- `WEB_APP_URL` - URL where your app is deployed\n- `SUPABASE_URL` - Supabase project URL (if using Supabase)\n- `SUPABASE_KEY` - Supabase project key (if using Supabase)\n- `VITE_TELEGRAM_BOT_LINK` - Link to your Telegram bot\n\n---\n\n## Star the Repository\n\nIf you find PyVueBot useful, please consider giving it a star on GitHub! Your support helps the project grow.\n\n[![GitHub Repo stars](https://img.shields.io/github/stars/venopyx/pyvuebot?style=social)](https://github.com/venopyx/pyvuebot)\n\n```bash\n# Or clone and star through GitHub CLI\ngh repo clone venopyx/pyvuebot\ngh repo star venopyx/pyvuebot\n```\n\n---\n## Development\n\nTo contribute to PyVueBot:\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/venopyx/pyvuebot.git\ncd pyvuebot\n```\n\n2. Install dependencies:\n\n```bash\npoetry install\n```\n\n3. Create a new branch:\n\n```bash\ngit checkout -b feature/your-feature\n```\n\n4. Make your changes and submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details\n\n## Author\n\n- Gemechis Chala ([@venopyx](https://github.com/venopyx))\n- Email: venopyx@gmail.com\n\n## Support\n\n- GitHub Issues: [Report bugs](https://github.com/venopyx/pyvuebot/issues)\n- Telegram: [@venopyx](https://t.me/venopyx)\n- Twitter: [@venopyx](https://twitter.com/venopyx)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvenopyx%2Fpyvuebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvenopyx%2Fpyvuebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvenopyx%2Fpyvuebot/lists"}