{"id":24404066,"url":"https://github.com/yashraj-n/astitva","last_synced_at":"2026-04-06T21:30:59.464Z","repository":{"id":273234677,"uuid":"919051344","full_name":"yashraj-n/astitva","owner":"yashraj-n","description":"🖼 Astitva is an AI-driven platform that transforms images into captivating stories, heartfelt poems, and creative captions.","archived":false,"fork":false,"pushed_at":"2025-01-19T17:22:28.000Z","size":371,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-31T10:40:27.935Z","etag":null,"topics":["ai","flask","generative-ai","nextjs","python","worqhatai"],"latest_commit_sha":null,"homepage":"https://astitva-frontend.yashrajn.com/","language":"TypeScript","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/yashraj-n.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}},"created_at":"2025-01-19T15:33:18.000Z","updated_at":"2025-01-19T17:23:02.000Z","dependencies_parsed_at":"2025-01-22T18:01:12.443Z","dependency_job_id":null,"html_url":"https://github.com/yashraj-n/astitva","commit_stats":null,"previous_names":["yashraj-n/astitva"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yashraj-n/astitva","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashraj-n%2Fastitva","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashraj-n%2Fastitva/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashraj-n%2Fastitva/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashraj-n%2Fastitva/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashraj-n","download_url":"https://codeload.github.com/yashraj-n/astitva/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashraj-n%2Fastitva/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31491094,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"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","flask","generative-ai","nextjs","python","worqhatai"],"created_at":"2025-01-20T03:58:41.948Z","updated_at":"2026-04-06T21:30:59.319Z","avatar_url":"https://github.com/yashraj-n.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://astitva-frontend.yashrajn.com/\" target=\"_blank\" title=\"Visit Us\"\u003e\u003cimg width=\"120px\" alt=\"logo\" src=\"https://em-content.zobj.net/source/twitter/77/lower-left-paintbrush_1f58c.png\"\u003e\u003c/a\u003e\n\n\n\n\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n# Astitva\n\nAstitva is an AI-driven platform that transforms images into captivating stories, heartfelt poems, and creative captions. Built with Python Flask and Next.js/React, it leverages Worqhat APIs to demonstrate the boundless creativity of artificial intelligence. Astitva is designed to inspire and showcase AI's potential in storytelling, poetry, and social media engagement.\n\n\u003e #### ⚠ Due to cloudflare timeout issues, the hosted url will not work. Please Self Host the project to use it.\n\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n\n![Next JS](https://img.shields.io/badge/Next-black?style=for-the-badge\u0026logo=next.js\u0026logoColor=white)\n\n![Flask](https://img.shields.io/badge/flask-%23000.svg?style=for-the-badge\u0026logo=flask\u0026logoColor=white)\n![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge\u0026logo=python\u0026logoColor=ffdd54)\n[![Licence](https://img.shields.io/github/license/Ileriayo/markdown-badges?style=for-the-badge)](./LICENSE)\n\n\n\u003ca href=\"https://astitva-frontend.yashrajn.com/\" target=\"_blank\" title=\"Visit Us\"\u003e\n\u003cdel\u003eCheck out Astitva\u003c/del\u003e\n\u003c/a\u003e\n\n---\n\u003cdiv align=\"center\"\u003e\n\n## Key Features\n \n\u003cdiv align=\"left\"\u003e\n\n1. **Image-to-Story Generation**  \n   - Transforms images into immersive, context-aware stories.  \n   - Generates chapters with themes like mystery, thriller, or drama.  \n   - Maintains plot continuity and incorporates character backstories.  \n\n2. **Image-to-Poem Generation**  \n   - Creates meaningful poems inspired by the image's mood, theme, and setting.  \n   - Uses cues like solitude, love, or nature to craft unique, emotional expressions.  \n\n3. **Image-to-Caption Generation**  \n   - Generates engaging captions tailored to the image.  \n   - Suggests keywords and hashtags for social media visibility.  \n\n4. **Context Awareness**  \n   - Ensures continuity across story chapters and thematic alignment in poems.  \n   - Delivers human-like, consistent, and creative outputs.  \n\n5. **API Integration**  \n   - Powered by **Worqhat APIs** for accurate and efficient creative processing.  \n\n6. **Showcasing AI Creativity**  \n   - Demonstrates AI’s ability to transform static images into stories, poems, and captions.  \n   - Highlights AI as a creative collaborator bridging art and technology.  \n\nAstitva redefines creativity by merging artificial intelligence with storytelling, poetry, and content creation.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## Workflow\n\n\n\u003cdiv align=\"left\"\u003e\n\n1. **Upload Image:**\n   - Users provide an image to initiate the creative process.\n\n2. **AI Theme Analysis:**\n   - The AI identifies themes such as mystery, sadness, or joy based on image context.\n\n3. **Content Generation:**\n   - **Stories:** Chapter-based narratives crafted from the image’s themes and settings.\n   - **Poems:** Emotion-rich poetry inspired by the image’s mood.\n   - **Captions:** Keywords and captions tailored for social media use.\n\n4. **Result Presentation:**\n   - Generated content is presented in an intuitive and creative format for the user.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n\n### Backend\n\u003cdiv align=\"left\"\u003e\n\n   - **Python Flask:** Core framework for server-side logic and API handling.\n   - **WorqHat APIs:** Enables advanced AI capabilities for creative content generation. (Special mention to WorqHat for their support.)\n\n\u003cdiv align=\"center\"\u003e\n\n### Frontend\n\u003cdiv align=\"left\"\u003e\n\n   - **Next.js (React):** Provides a seamless and interactive user interface.\n   - **Tailwind CSS:** Facilitates responsive design and modern styling.\n   - **Chakra UI:** Offers a component library for consistent design elements.\n   - **Aceternity:** Provides a clean and aesthetic design theme.\n   - **Shadcn/ui:** Offers a custom UI library for enhanced user experience.\n   - **Clerk:** Provides authentication and user management capabilities.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## Installation\n\n\u003cdiv align=\"center\"\u003e\n\n### Prerequisites\n\u003cdiv align=\"left\"\u003e\n\n   - Python 3.7+\n   - Node.js 16+\n\n1. **Clone the Repository:**\n   ```bash\n   git clone https://github.com/yashraj-n/astitva\n   cd astitva\n   ```\n\n2. **Set Up Backend:**\n   - Install dependencies:\n     ```bash\n     pip install -r requirements.txt\n     ```\n   - Run the Flask server:\n     ```bash\n     python main.py\n     ```\n\n3. **Set Up Frontend:**\n   - Navigate to the `frontend` folder:\n     ```bash\n     cd frontend\n     ```\n   - Install dependencies:\n     ```bash\n     npm install\n     ```\n   - Start the development server:\n     ```bash\n     npm run dev\n     ```\n\n4. **Configure Environment Variables:**\n   - Set up API keys and endpoints for WorqHat APIs in a `.env` file.\n   - Ensure Clerk API key is added in the `.env.local` file for frontend usage.\n   - Rename `env.example` files to `.env` for backend and `.env.local` for frontend.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## Usage\n\u003cdiv align=\"left\"\u003e\n\n1. Open the application at `http://localhost:3000`.\n2. Upload an image of your choice.\n3. Choose the desired output type:\n   - **Story**: Get a detailed narrative.\n   - **Poem**: Receive a poetic creation.\n   - **Caption**: Generate social media-ready captions.\n4. Enjoy and save your AI-generated content!\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## Screenshots\n\n\u003cimg src=\"./assets//Screenshot_2025-01-19_at_10.40.19_PM_png.jpg\" width=\"100%\"\u003e\n\n\n\u003cimg src=\"https://lambda.yashraj.eu.org/kgvuKba\" alt=\"Workflow Example\" width=\"100%\"\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## Credits\n\u003cdiv align=\"left\"\u003e\n\n- **WorqHat APIs:** Acknowledgment for providing robust AI capabilities.\n- **CSI @ MIT-WPU:** For organising an amazing hackathon.\n\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashraj-n%2Fastitva","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashraj-n%2Fastitva","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashraj-n%2Fastitva/lists"}