{"id":28348145,"url":"https://github.com/pranavarya37/instacaption","last_synced_at":"2026-01-20T16:29:35.545Z","repository":{"id":294957318,"uuid":"988314210","full_name":"PranavArya37/InstaCaption","owner":"PranavArya37","description":"AI-powered Instagram caption generator. Upload your photo and get creative captions instantly! Built with Next.js, Genkit, and ShadCN UI.","archived":false,"fork":false,"pushed_at":"2025-06-27T21:53:27.000Z","size":619,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-30T01:41:25.786Z","etag":null,"topics":["ai","artificial-intelligence","genkit","instagram","instagram-captions","nextjs","shadcn-ui"],"latest_commit_sha":null,"homepage":"https://instacaptionxp.vercel.app","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/PranavArya37.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}},"created_at":"2025-05-22T11:16:31.000Z","updated_at":"2025-06-27T21:53:30.000Z","dependencies_parsed_at":"2025-07-30T01:20:27.612Z","dependency_job_id":"0bcb1c78-6af1-4142-8b39-042cee246e9c","html_url":"https://github.com/PranavArya37/InstaCaption","commit_stats":null,"previous_names":["pranavarya37/instacaption"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PranavArya37/InstaCaption","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PranavArya37%2FInstaCaption","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PranavArya37%2FInstaCaption/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PranavArya37%2FInstaCaption/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PranavArya37%2FInstaCaption/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PranavArya37","download_url":"https://codeload.github.com/PranavArya37/InstaCaption/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PranavArya37%2FInstaCaption/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28607152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T16:10:39.856Z","status":"ssl_error","status_checked_at":"2026-01-20T16:10:39.493Z","response_time":117,"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":["ai","artificial-intelligence","genkit","instagram","instagram-captions","nextjs","shadcn-ui"],"created_at":"2025-05-27T18:10:19.049Z","updated_at":"2026-01-20T16:29:35.519Z","avatar_url":"https://github.com/PranavArya37.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InstaCaption 📸✨\n\n  \n\nInstaCaption is an AI-powered web application that helps you generate engaging Instagram captions for your photos in seconds! Simply upload your image, and let our AI craft the perfect words to accompany your posts.\n\n  \n\n## Features\n\n  \n\n-  **Easy Photo Upload**: Supports PNG, JPG, GIF, and WEBP image formats.\n\n-  **AI-Powered Captions**: Get multiple creative caption suggestions tailored to your image.\n\n-  **One-Click Copy**: Quickly copy your favorite caption to your clipboard.\n\n-  **Responsive Design**: Looks great and works seamlessly on desktops, tablets, and mobile devices.\n\n-  **User-Friendly Interface**: Clean and intuitive design for a smooth experience.\n\n-  **Image Size Validation**: Prevents uploads of images larger than 4MB to ensure optimal performance.\n\n-  **Error Handling**: Clear notifications for any issues during the process.\n\n-  **Dark Mode Support**: Adapts to your system's preferred theme.\n\n  \n\n## Tech Stack\n\n  \n\n-  **Frontend**:\n\n\t- [Next.js](https://nextjs.org/) (App Router, Server Components, Server Actions)\n\n\t- [React](https://reactjs.org/)\n\n\t- [TypeScript](https://www.typescriptlang.org/)\n\n\t- [ShadCN UI](https://ui.shadcn.com/) (for UI components)\n\n\t- [Tailwind CSS](https://tailwindcss.com/) (for styling)\n\n-  **Backend/AI**:\n\n\t- [Genkit (Firebase Genkit)](https://firebase.google.com/docs/genkit) (for AI integration)\n\t\n\t- Google Gemini (via Genkit for caption generation)\n\n-  **Development**:\n\n\t- Firebase Studio (Development Environment)\n\n  \n\n## Getting Started\n\n  \n\nFollow these steps to get InstaCaption running on your local machine.\n\n  \n\n### Prerequisites\n\n  \n\n- Node.js (v18 or later recommended)\n\n- npm, yarn, or pnpm\n\n  \n\n### Installation \u0026 Setup\n\n  \n\n1.  **Clone the repository:**\n\n```bash\n\ngit clone https://github.com/PranavArya37/InstaCaption\n\ncd InstaCaption\n\n```\n\n  \n\n2.  **Install dependencies:**\n\n```bash\n\nnpm install\n\n# or\n\n# yarn install\n\n# or\n\n# pnpm install\n\n```\n\n  \n\n3.  **Set up environment variables:**\n\nCreate a `.env` file in the root of your project and add your Google AI API key. You can obtain one from the [Google AI Studio](https://aistudio.google.com/app/apikey).\n\n```env\n\nGOOGLE_API_KEY=your_google_api_key_here\n\n```\n\n  \n\n4.  **Run the development server:**\n\nThe application uses two concurrent development servers: one for the Next.js app and one for Genkit.\n\n  \n\n*  **Start the Next.js development server:**\n\n```bash\n\nnpm run dev\n\n```\n\nThis will typically start the app on [http://localhost:9002](http://localhost:9002).\n\n  \n\n*  **Start the Genkit development server (in a separate terminal):**\n\n```bash\n\nnpm run genkit:dev\n\n# or for auto-reloading on changes\n\n# npm run genkit:watch\n\n```\n\nThis will start the Genkit developer UI, usually on [http://localhost:4000](http://localhost:4000), where you can inspect and test your Genkit flows.\n\n  \n\n5.  **Open the app:**\n\nNavigate to [http://localhost:9002](http://localhost:9002) (or the port your Next.js app is running on) in your browser.\n\n  \n\n## Project Structure\n\n  \n\n-  `src/app/`: Contains the Next.js pages and core application logic.\n\n-  `page.tsx`: The main page component for InstaCaption.\n\n-  `actions.ts`: Server actions for handling form submissions and AI calls.\n\n-  `layout.tsx`: The main layout component.\n\n-  `globals.css`: Global styles and ShadCN theme variables.\n\n-  `src/ai/`: Contains Genkit related code.\n\n-  `genkit.ts`: Genkit configuration and initialization.\n\n-  `flows/`: Genkit flows for AI interactions (e.g., `generate-image-caption.ts`).\n\n-  `src/components/`: Shared UI components, including ShadCN UI components.\n\n-  `src/hooks/`: Custom React hooks (e.g., `use-toast.ts`).\n\n-  `src/lib/`: Utility functions.\n\n-  `public/`: Static assets.\n\n  \n\n## Screenshots\n\n  \n\n\n\n  \n\n**Upload Section:**\n\n\n\n\u003cdiv  align=\"center\"\u003e\n\n\u003cimg  src=\"/screenshots/Screenshot1.jpeg\"  alt=\"InstaCaption Upload Section\"  width=\"70%\"  data-ai-hint=\"app interface\"\u003e\n\n\u003c/div\u003e\n\n  \n\n**Caption Generation Results:**\n\n\n\n\u003cdiv  align=\"center\"\u003e\n\n\u003cimg  src=\"/screenshots/Screenshot2.jpeg\"  alt=\"InstaCaption Results\"  width=\"70%\"  data-ai-hint=\"caption results\"\u003e\n\n\u003c/div\u003e\n\n  \n  \n\n## Contributing\n\n  \n\nContributions are welcome! If you have suggestions for improvements or new features, feel free to:\n\n  \n\n1. Fork the Project\n\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n\n5. Open a Pull Request\n\n  \n\n## License\n\n  \n\nThis project is licensed under the MIT License. See the `LICENSE` file for details (if one exists, otherwise assume MIT).\n\n  \n\n---\n\n  \n\nMade with ❤️ by [Pranav Arya](https://pranavarya.in) and enhanced with AI in Firebase Studio.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavarya37%2Finstacaption","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranavarya37%2Finstacaption","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavarya37%2Finstacaption/lists"}