{"id":24361844,"url":"https://github.com/daeh/comosoco-env","last_synced_at":"2026-03-03T21:31:08.618Z","repository":{"id":271194671,"uuid":"912670512","full_name":"daeh/comosoco-env","owner":"daeh","description":"PPL environment for the course \"Computational Models of Social Cognition\"","archived":false,"fork":false,"pushed_at":"2026-01-15T03:26:56.000Z","size":404,"stargazers_count":1,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-15T09:34:26.284Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","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/daeh.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":"2025-01-06T06:38:24.000Z","updated_at":"2026-01-15T03:27:00.000Z","dependencies_parsed_at":"2025-01-29T07:19:44.434Z","dependency_job_id":"abf2ee1b-b827-4455-817a-a2effa640ac8","html_url":"https://github.com/daeh/comosoco-env","commit_stats":null,"previous_names":["daeh/comosoco-env"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/daeh/comosoco-env","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daeh%2Fcomosoco-env","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daeh%2Fcomosoco-env/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daeh%2Fcomosoco-env/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daeh%2Fcomosoco-env/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daeh","download_url":"https://codeload.github.com/daeh/comosoco-env/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daeh%2Fcomosoco-env/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30062342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2025-01-18T22:03:24.835Z","updated_at":"2026-03-03T21:31:08.580Z","avatar_url":"https://github.com/daeh.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Computational Models of Social Cognition (CoMoSoCo) - Python Environment\n\nThis repository contains a starter Python environment for running Jupyter notebooks used in the Computational Models of Social Cognition course. \n\n## Environment Setup\n\nFor this course, you need a Python environment that lets you run Jupyter Notebooks with `memo` models. While this guide suggests creating an environment that matches the one I'll be using for the tutorials, you can also use a more minimal setup. As long as you can successfully run notebooks like [`comosoco/installation-test.ipynb`](./comosoco/installation-test.ipynb), your setup should be sufficient.\n\n### Install `Homebrew` (MacOS only)\n\n\u003e [Homebrew](https://brew.sh/) is a package manager for MacOS that simplifies software installation and management.\n\nFollow the installation instructions on [https://brew.sh](https://brew.sh)\n\n**Verify the installation:**\n\n```bash\nbrew --version\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eI can't or don't want to use homebrew!\u003c/summary\u003e\n  No problem, it just makes it easier to install and remove things on MacOS.\n\u003c/details\u003e\n\n### Install `git`\n\n\u003e [git](https://git-scm.com/) is a version control system that helps manage code. Here's how to install it:\n\n**With Homebrew:**\n\n```bash\nbrew install git\n```\n\n**Without Homebrew:**\n\nFollow the installation instructions on [https://git-scm.com/download/win](https://git-scm.com/download/win)\n\n**Verify the installation:**\n\n```bash\ngit --version\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eI can't or don't want to use git!\u003c/summary\u003e\n  But git is great! Ok, though, you can skip it for now and download the repository directly as a ZIP file (see \"Getting the Repository\" section below).\n\u003c/details\u003e\n\n\n### Install `uv`\n\n\u003e [Astral uv](https://docs.astral.sh/uv/) is a fast Python package installer that we'll use to set up the environment.\n\n**With Homebrew:**\n\n```bash\nbrew install uv\n```\n\n**Without Homebrew:**\n\nFollow the install instructions on \u003chttps://docs.astral.sh/uv/getting-started/installation/\u003e\n\n**Verify the installation:**\n\n```bash\nuv --version\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eI can't or don't want to use uv!\u003c/summary\u003e\n  Ok, we can work around that.\n\u003c/details\u003e\n\n### Install `Task` (MacOS only)\n\n\u003e [Task](https://taskfile.dev/) is a task runner that simplifies common commands. While Task is not specific to MacOS, at the moment this repository only supports Task on MacOS.\n\n**With Homebrew:**\n```bash\nbrew install go-task\n```\n\n**Without Homebrew:**\n\nFollow the installation instructions on \u003chttps://taskfile.dev/installation/\u003e\n\n**Verify the installation:**\n\n```bash\ntask --version\n```\n\u003cdetails\u003e\n  \u003csummary\u003eI can't or don't want to use Task!\u003c/summary\u003e\n  No problem, it's just for convenience.\n\u003c/details\u003e\n\n\n### Install Visual Studio Code\n\nVS Code is the recommended editor for this course:\n\n1. Download VS Code from [https://code.visualstudio.com](https://code.visualstudio.com)\n2. Install the downloaded file\n\n\u003cdetails\u003e\n  \u003csummary\u003eI can't or don't want to use VS Code!\u003c/summary\u003e\n  You can use any editor that supports Jupyter notebooks, but this README only gives instructions for VS Code.\n\u003c/details\u003e\n\n### Clone this repository\n\nChoose one of these methods:\n\n**Option 1: Fork and Clone (Recommended)**\n1. Create a GitHub account if you don't have one\n2. Go to this repository [https://github.com/daeh/comosoco-env](https://github.com/daeh/comosoco-env)\n3. Click the \"Fork\" button in the top-right corner\n4. Clone your fork:\n   ```bash\n   git clone https://github.com/YOUR-USERNAME/comosoco-env.git\n   cd comosoco-env\n   ```\n\n**Option 2: Direct Clone**\n```bash\ngit clone https://github.com/daeh/comosoco-env.git\ncd comosoco-env\n```\n\n**Option 3: Direct Download**\n\n1. Visit [https://github.com/daeh/comosoco-env](https://github.com/daeh/comosoco-env)\n2. Click the green \"Code\" button\n3. Select \"Download ZIP\"\n4. Extract the ZIP file\n5. Navigate to the `comosoco-env` folder in your terminal\n\n### Installing the Environment\n\nMake sure you're in the `comosoco-env` directory, then choose one method:\n\n**Option 1: Using `Task` (Easiest, MacOS)**\n\n```bash\ntask install\n```\n\n**Option 2: Using `uv`**\n\n```bash\nuv sync\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003eOption 3: Using \u003ccode\u003epip\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\n1, Make a virtual environment:\n\n```bash\npython -m venv .venv\n```\n\n2. Activate the environment:\n\nMacOS/Linux:\n\n```bash\nsource .venv/bin/activate\n```\n\nWindows (Command Prompt):\n\n```cmd\n.venv\\Scripts\\activate.bat\n```\n\nWindows (PowerShell):\n\n```powershell\n.venv\\Scripts\\Activate.ps1\n```\n\n3. Install packages:\n\n```bash\npip install -r requirements-standard.txt\n```\n\nIf you encounter issues, try using `requirements-minimal.txt` instead:\n\n```bash\npip install -r requirements-minimal.txt\n```\n\n\u003c/details\u003e\n\n\n### Setting up `VS Code`\n\n1. Open the VS Code application\n\n2. Open `VSCProject.code-workspace`\n\n   ![open-workspace](assets/open-workspace.png) \n\n   - You should see that the window name is \"comosoco\"\n\n     ![window-name](assets/window-name.png)\n\n3. When prompted, **install recommended extensions**\n\n   ![recommended-extensions-manual](assets/recommended-extensions-prompt.png)\n   \n   - Troubleshooting: If you don't see a prompt to install the recommended extensions, make sure you've correctly open the `VSCProject.code-workspace` file. You should see \"comosoco\" as the window name.\n   \n   - Troubleshooting: If you're sure you have the workspace open, you can manually install the extensions by searching for `@recommended` in the Extension Pane\n   \n     ![recommended-extensions-manual](assets/recommended-extensions-manual.png)\n   \n4. Open `comosoco/installation-test.ipynb`\n\n5. Set the Jupyter notebook to use the `.venv` python in `comosoco-env`\n   - See below for screen shots.\n\n6. Run all cells in the notebook - if they complete without error, your setup is working!\n\n![1](assets/1.png)\n\n![2](assets/2.png)\n\n![3](assets/3.png)\n\n![4](assets/4.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaeh%2Fcomosoco-env","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaeh%2Fcomosoco-env","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaeh%2Fcomosoco-env/lists"}