{"id":18151279,"url":"https://github.com/ivanhuay/devblog-ai","last_synced_at":"2025-07-04T00:34:22.394Z","repository":{"id":257919959,"uuid":"872778442","full_name":"ivanhuay/devblog-ai","owner":"ivanhuay","description":"Devblog AI is a local platform that uses raw notes and the ChatGPT API to automatically generate full dev blog posts. This monorepo contains both the API (backend) and the UI (frontend) projects, which can be run together using Docker.","archived":false,"fork":false,"pushed_at":"2024-10-15T19:42:03.000Z","size":628,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T23:32:17.337Z","etag":null,"topics":["aitools","blogging","chatgpt-api","claude-ai"],"latest_commit_sha":null,"homepage":"","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/ivanhuay.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":"2024-10-15T04:02:18.000Z","updated_at":"2024-10-16T16:16:25.000Z","dependencies_parsed_at":"2024-10-17T01:30:58.806Z","dependency_job_id":"7c3edd2e-16eb-44ad-9870-b5f6ae0a2739","html_url":"https://github.com/ivanhuay/devblog-ai","commit_stats":null,"previous_names":["ivanhuay/devblog-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ivanhuay/devblog-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanhuay%2Fdevblog-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanhuay%2Fdevblog-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanhuay%2Fdevblog-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanhuay%2Fdevblog-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivanhuay","download_url":"https://codeload.github.com/ivanhuay/devblog-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanhuay%2Fdevblog-ai/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263426393,"owners_count":23464795,"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":["aitools","blogging","chatgpt-api","claude-ai"],"created_at":"2024-11-02T01:07:12.324Z","updated_at":"2025-07-04T00:34:22.363Z","avatar_url":"https://github.com/ivanhuay.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Devblog AI - Monorepo (Beta)\n\nDevblog AI is a local platform that uses raw notes and the ChatGPT API to automatically generate full dev blog posts. This monorepo contains both the API (backend) and the UI (frontend) projects, which can be run together using Docker.\n\n## Prerequisites\n\n- **Docker** and **Docker Compose** installed on your local machine.\n- A **ChatGPT API key**, as it is required to generate the content.\n\n## Getting Started\n\nTo run the project locally with Docker, follow the steps below.\n\n### 1. Clone the Repository\n\nFirst, clone this repository to your local machine:\n\n```bash\ngit clone https://github.com/ivanhuay/devblog-ai.git\ncd devblog-ai-monorepo\n```\n\n### 2. Set Up the API\n\nNavigate to the API directory and set up the environment variables:\n\n```bash\ncd ./devblog-ia-api\ncp .env.template .env\n```\n\nMake sure to update the \\`.env\\` file with the necessary values:\n- **CHATGPT_API_KEY**: You need to provide your ChatGPT API key here for the blog generation feature to work.\n- The default database configuration for MongoDB is already set. If necessary, adjust the \\`DB_URL\\`, \\`DB_PORT\\`, or \\`DB_NAME\\` in the \\`.env\\` file.\n\n### 3. Set Up the UI\n\nSimilarly, navigate to the UI directory and configure the environment variables:\n\n```bash\ncd ./devblog-ia-ui\ncp .env.template .env\n```\n\nIn the \\`.env\\` file, set the **NEXT_PUBLIC_API_URL** to point to the API:\n\n```\nNEXT_PUBLIC_API_URL=http://localhost:4001\n```\n\nThis ensures the UI connects to the backend correctly.\n\n### 4. Run the Application\n\nAfter setting up both the API and UI, return to the root directory of the project:\n\n```bash\ncd ..\n```\n\nNow, you can run the entire application using Docker Compose:\n\n```bash\ndocker-compose up --build\n```\n\nDocker will build and run the following services:\n- **API**: Available at \\`http://localhost:4001\\`\n- **UI**: Available at \\`http://localhost:3000\\`\n- **MongoDB**: The database service, used by the API.\n\n### 5. Open the Application\n\nOnce the services are up and running, navigate to \\`http://localhost:3000\\` in your browser to access the Devblog AI application.\n![alt text](image.png)\n## Usage\n\n1. **Create a Note**: On the main page, click the \"Create Note\" button to input your raw notes.\n2. **Generate Blog Post**: After inputting your notes, go to the \"Blog Post\" tab and click on \"Generate\". The app will use the ChatGPT API to generate a full blog post based on your notes.\n3. **Review and Edit**: You can review and edit the generated blog post directly in the editor.\n4. **Generate Social Post**: Once satisfied with your blog post, navigate to the \"Social Post\" tab and click \"Generate\". This will create a shorter social media version of the post.\n5. **Edit and Save**: You can edit the final social media post in the \"Social Post\" tab. The final version will be stored automatically for future use.\n\n## Environment Variables Overview\n\n### API (\\`devblog-ia-api/.env\\`)\n- \\`PORT=4001\\`: Port on which the API will run.\n- \\`DB_URL=mongodb://mongodb:27017\\`: MongoDB connection string.\n- \\`DB_NAME=devblog\\`: Name of the MongoDB database.\n- \\`CHATGPT_API_KEY=your-api-key\\`: Required API key for ChatGPT integration.\n\n### UI (\\`devblog-ia-ui/.env\\`)\n- \\`NEXT_PUBLIC_API_URL=http://localhost:4001\\`: The URL for the API, used by the UI to communicate with the backend.\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivanhuay%2Fdevblog-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivanhuay%2Fdevblog-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivanhuay%2Fdevblog-ai/lists"}