Merge pull request #16 from codez0mb1e/uv-ruff

Setup scripts for `uv` + `ruff` and AI development environments

Author: codez0mb1e

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017-2024 Dmitry Petukhov
+Copyright (c) 2017-2025 Dmitry Petukhov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

ai-agents/agents.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+#
+# AI agents development environment setup
+#
+# This script sets up:
+# - Infra
+# - Frameworks
+# - Tools
+#
+# Note: will be decomposed into separate scripts later
+# Usage: ./agents.sh
+#
+
+
+# 0. Install Ollama [1]
+# install
+cd ~
+curl -fsSL https://ollama.com/install.sh | sh
+
+# checks
+ollama -v
+
+# load LLMs
+ollama run llama3.2
+ollama run deepseek-coder
+
+
+# Connect Ollama to Open-WebUI [2]
+docker network create ollama-net
+
+docker run -d --network ollama-net -p 3000:8080 \
+    -v ollama:/root/.ollama \
+    -v open-webui:/app/backend/data \
+    --name open-webui \
+    --restart always \
+    ghcr.io/open-webui/open-webui:ollama
+
+# open http://localhost:3000 in browser for web UI
+
+
+# 1. Install AutoGen ----
+
+uv add "autogen-core" "autogen-agentchat"
+uv add "autogen-ext[web-surfer,openai,ollama,azure]"
+uv sync --all-extras
+
+
+# 2. Install Playwright ----
+playwright install
+
+
+# References:
+# 1. https://github.com/ollama/ollama/blob/main/docs/linux.md
+# 2. https://github.com/open-webui/open-webui?tab=readme-ov-file#how-to-install-

development/install_ds_python.sh development/install_conda.shdevelopment/install_ds_python.sh renamed to development/install_conda.sh

@@ -17,6 +17,7 @@ echo \
   $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
   sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 
+
 # 1. Install ----
 # install packages
 sudo apt -y update
@@ -57,6 +58,9 @@ docker logs portainer
 # Docker Hub
 docker login -u <username> -p <password>
 
+# GitHub Container Registry
+echo <gh_token> | docker login ghcr.io -u <username> --password-stdin
+
 # Azure Container Registry
 az login
 az acr login -n <acr_name>

development/install_docker.sh

@@ -4,12 +4,14 @@
 # Install .NET
 #
 
-# 1. Install .NET 8 ----
+# 1. Install .NET 9 ----
 # install
-sudo apt install -y dotnet-sdk-8.0
+sudo add-apt-repository ppa:dotnet/backports
+sudo apt-get update && \
+  sudo apt-get install -y dotnet-sdk-9.0
 # validate
 dotnet --info
 
 
 # References ----
-# 1. https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2404&tabs=dotnet8
+# 1. https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install?pivots=os-linux-ubuntu-2404&tabs=dotnet9

development/install_dotnet_tools.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+
+#
+# Install `uv` and `ruff` for Python development
+#
+
+
+# 0. Install uv ----
+# install
+curl -LsSf https://astral.sh/uv/install.sh | sh
+# check
+uv -V
+# turn on auto-updates
+uv self update
+
+
+# 1. Install Python tools for uv ----
+# Install Python 3.12
+uv python install 3.12
+uv python list 3.12
+echo 'import platform; print(platform.python_version())' | uv run -
+
+uv python upgrade 3.12
+
+# Install venv
+uv venv
+
+
+# Install ruff (globally)
+uv tool install ruff@latest
+ruff --version
+
+uv tool upgrade ruff
+
+
+# 2. Create a new project ----
+cd projects/
+uv init -n ai-agents
+cd ai-agents
+
+uv add ruff # if not installed globally yet
+uv lock
+
+
+# 3. Configure ruff for Python projects ----
+mkdir -p ~/.config/ruff
+cat <<EOF > ~/.config/ruff/config.toml
+[tool.ruff]
+line-length = 120
+select = ["E", "F", "W", "C90"]
+exclude = ["__pycache__", "venv", ".git", ".ruff_cache"]
+fix = true
+target-version = "py312"
+
+[tool.ruff.per-file-ignores]
+"__init__.py" = ["F401"]
+EOF
+
+echo "Ruff configuration file created at ~/.config/ruff/config.toml"
+
+ruff check --config ~/.config/ruff/config.toml --fix --exit-zero
+echo "Ruff configuration validated successfully."
+
+
+# References ----
+# 1. https://docs.astral.sh/uv/getting-started/features/
+# 2. https://marketplace.visualstudio.com/items?itemName=charliermarsh.ruff