{"id":35881688,"url":"https://github.com/ubeast/first-repo","last_synced_at":"2026-01-08T18:03:56.763Z","repository":{"id":331162602,"uuid":"1125525402","full_name":"ubeast/first-repo","owner":"ubeast","description":"Beginner-friendly Python starter: GitHub integration, uv setup, package-ready.","archived":false,"fork":false,"pushed_at":"2025-12-31T00:00:55.000Z","size":10,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-03T21:49:31.031Z","etag":null,"topics":["beginner","git","github","packaging","project-setup","python","python-project","tutorial","uv","version-control"],"latest_commit_sha":null,"homepage":"","language":"Python","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/ubeast.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-30T22:15:18.000Z","updated_at":"2025-12-31T00:00:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ubeast/first-repo","commit_stats":null,"previous_names":["ubeast/first-repo"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ubeast/first-repo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ubeast%2Ffirst-repo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ubeast%2Ffirst-repo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ubeast%2Ffirst-repo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ubeast%2Ffirst-repo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ubeast","download_url":"https://codeload.github.com/ubeast/first-repo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ubeast%2Ffirst-repo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28247285,"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","status":"online","status_checked_at":"2026-01-08T02:00:06.591Z","response_time":241,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["beginner","git","github","packaging","project-setup","python","python-project","tutorial","uv","version-control"],"created_at":"2026-01-08T18:01:22.236Z","updated_at":"2026-01-08T18:03:56.752Z","avatar_url":"https://github.com/ubeast.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\r\n\u003cimg width=\"1536\" height=\"1024\" alt=\"first-project\" src=\"https://github.com/user-attachments/assets/fd9b6d79-3717-4fa4-b2cc-224b7f3aa5e6\" /\u003e\r\n\r\n# 🐍 **Easy-to-Use Python Project Setup: Connect GitHub to Your Local**\r\n\r\n**⚡ Future-proof \u0026 ready for packaging, perfect for beginners**\r\n\r\nGetting from *writing code* to *managing a professional project* can feel overwhelming. This guide walks you through creating a **Python project** that’s **structured, maintainable, and connected to GitHub**—step by step.\r\n\r\nWe’ll use **`uv`** to set up your project professionally from day one.\r\n\r\n---\r\n\r\n## 📌 **First, Some Preliminaries**\r\n\r\nBefore we start, here’s what you need to know:\r\n\r\n* **Why `uv`?**\r\n\r\n  * ✅ Creates a **clean project structure** (`src/` layout)\r\n  * ✅ Locks dependencies for **consistent behavior** across computers\r\n  * ✅ Makes **future packaging and sharing** easy\r\n\r\n* **Why not `pip`?**\r\n\r\n  * ❌ No lockfile by default\r\n  * ❌ No enforced project structure\r\n  * ❌ Less predictable dependency management\r\n\r\n* **Prerequisites:**\r\n\r\n  * **Git**: Version control system to connect your project to GitHub. [Download Git](https://git-scm.com)\r\n  * **uv**: Python project management tool. [Download uv](https://uv.org)\r\n\r\n\u003e ✅ **Once Git and `uv` are installed, you’re ready to start.**\r\n\r\n---\r\n\r\n## Step 1: **Create Your GitHub Repository**\r\n\r\n**Goal:** Set up your remote **“Source of Truth.”**\r\n\r\n1. Go to [GitHub.com](https://github.com) and sign up if you don’t have an account.\r\n2. Click the **green [New] button**.\r\n3. **Name your repository:** `first-repo`\r\n4. **Set visibility:**\r\n\r\n   * 🔒 **Private:** Only you and invited collaborators can see it\r\n   * 🌍 **Public:** Anyone can view it\r\n5. ⚠️ **Important:** Do **not** check “Add a README” or “.gitignore.”\r\n\r\n   \u003e The repository must be **empty** for the Handshake to work smoothly.\r\n6. Click **Create repository** ✅\r\n\r\n\u003e Your empty GitHub repository is ready!\r\n\r\n---\r\n\r\n## Step 2: **Prepare Your Local Workspace**\r\n\r\n**Goal:** Create a clean folder for your project on your computer.\r\n\r\n```bash\r\nmkdir first-repo   # Create the project folder\r\ncd first-repo      # Move into the folder\r\nrm -rf .git        # Remove any existing Git configuration\r\n```\r\n\r\n\u003e ✅ Local workspace is ready.\r\n\r\n---\r\n\r\n## Step 3: **Configure Your Project**\r\n\r\n**Goal:** Initialize your project with a professional layout and lock dependencies.\r\n\r\n```bash\r\nuv init --lib       # Creates src/ folder and project structure\r\nuv sync             # Generates uv.lock for dependencies\r\n```\r\n\r\n\u003e ✅ Your project now has a professional **src/ layout** and locked dependencies.\r\n\r\n---\r\n\r\n## Step 4: **Connect Your Project to GitHub**\r\n\r\n**Goal:** Link your local project to your remote repository and push your first commit.\r\n\r\n```bash\r\ngit init\r\ngit add .\r\ngit commit -m \"initial setup\"\r\ngit branch -M main\r\ngit remote add origin https://github.com/USER/first-repo.git\r\ngit push -u origin main\r\n```\r\n\r\n\u003e Replace `USER` with your GitHub username.\r\n\r\n\u003e ✅ Your project is now connected to GitHub! Future changes can be committed and pushed.\r\n\r\n---\r\n\r\n## ✅ **Next Steps**\r\n\r\n* 💻 Start coding in `src/first_repo/`\r\n* 🧪 Add tests in `tests/` and run them with `pytest`\r\n* 🔄 Commit changes regularly and push to GitHub\r\n* 📦 Explore publishing your project as a Python package later\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fubeast%2Ffirst-repo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fubeast%2Ffirst-repo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fubeast%2Ffirst-repo/lists"}