A Django-based project workspace generator and task manager that uses OpenAI to turn high-level project discovery conversations into an editable workspace.
codebuddy is a small Django app for authenticated users to:
- create a new project
- answer discovery questions for a project idea
- generate an initial workspace with sections like Overview, Requirements, Roadmap, Tasks, Resources, Budget, Learning, Documentation, and Testing
- manage workspace folders and tasks
- regenerate individual workspace sections
It stores projects, AI conversation messages, workspace folders, and tasks in SQLite.
- Python 3.12+
- Django 6.0.x
- OpenAI Python SDK
- Pydantic
cd /home/ayan/codebuddy
python -m venv venv
source venv/bin/activate
pip install django openai pydanticIf you want to pin versions, use:
pip install "django>=6.0,<7.0" "openai>=1.0" "pydantic>=2.0"The app uses the OpenAI client in projects/ai/services.py, so you must set:
export OPENAI_API_KEY="your_openai_api_key"python manage.py migratepython manage.py createsuperuserpython manage.py runserverThen open your browser at:
http://127.0.0.1:8000/admin/— Django admin interfacehttp://127.0.0.1:8000/projects/— main app pages after login
- Log in as a user or admin.
- Visit
/projects/and start a new project. - Answer the discovery questions in the project setup flow.
- When the AI is ready, generate the workspace.
- Explore the generated workspace sections and tasks.
- Edit folder content or regenerate an individual section if needed.
A copy-and-paste friendly onboarding guide is available in USER_GUIDE.md.
manage.py— Django command-line entry pointcodebuddy/settings.py— Django settings with SQLite databaseprojects/models.py— Project, ProjectMessage, WorkspaceFolder, Taskprojects/views.py— project setup, workspace generation, folder/task pagesprojects/urls.py— app URL routesprojects/ai/services.py— OpenAI integration and workspace generation prompts
- This project runs in development mode (
DEBUG = True). - The SQLite database file is
db.sqlite3. - For production usage, update
SECRET_KEY,DEBUG, and database settings.