{"id":2471,"date":"2025-06-17T00:01:29","date_gmt":"2025-06-16T15:01:29","guid":{"rendered":"https:\/\/blog.peddals.com\/?p=2471"},"modified":"2025-06-17T00:01:29","modified_gmt":"2025-06-16T15:01:29","slug":"load-local-zshrc-in-pipenv","status":"publish","type":"post","link":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/","title":{"rendered":"Apply local aliases and exports in pipenv\/Python"},"content":{"rendered":"\n

This article explains a method to automatically load a configuration file (like .zshrc<\/code>) containing aliases and exports in the current directory when zsh (bash) is loaded. The Python virtual environment pipenv<\/code> loads a new shell, which allows aliases and other settings to be automatically applied. When exiting pipenv<\/code>, the virtual environment’s settings become invalid, so they do not affect your base shell or other environments. This can be implemented easily (and effectively), but probably because pipenv<\/code> isn’t that popular, I could not find exact information easily. Hope you love it.<\/p>\n\n\n\n

Environment<\/h2>\n\n\n\n

Shell: zsh<\/code> (bash<\/code> seems to work as well.)<\/p>\n\n\n\n

Python virtual environment: pipenv<\/code><\/p>\n\n\n\n

OS: macOS Sequoia (should not matter)<\/p>\n\n\n\n

Steps<\/h2>\n\n\n\n

To use pipenv<\/code> on macOS, first install it with brew install pipenv<\/code>. The steps to easily create a virtual environment are like this:<\/p>\n\n\n\n

mkdir my_project # Create a project directory.\ncd my_project # Go in to the directory.\npipenv --python 3.11 # Create a virtual environment with Python 3.11\npipenv shell # Enter the virtual env. To exit, enter "exit" or press ctrl + D<\/code><\/pre><\/div>\n\n\n\n
Add a line to ~\/.zshrc.<\/h3>\n\n\n\n
Add the following to the .zshrc<\/code> in your home directory.<\/p>\n\n\n\n
# Load .zshrc.local if it exists in the current directory.\n[[ -f .zshrc.local ]] && source .zshrc.local<\/code><\/pre><\/div>\n\n\n\n
This checks whether the .zshrc.local<\/code> file exists in the current directory as a conditional expression on the left side of &&<\/code>. If it is true, the source<\/code> command on the right is executed, loading the .zshrc.local<\/code> file (I haven’t tried it, but apparently the same method works in bash<\/code> in terms of syntax).<\/p>\n\n\n\n
Place .zshrc.local in the root of pipenv directory.<\/h3>\n\n\n\n
Of course, anything you can write in .zshrc<\/code> such as alias<\/code> or export<\/code> are allowed to be added. Here is a simple sample for reference:<\/p>\n\n\n\n
alias t='time'\nexport HW="Hello, World!"<\/code><\/pre><\/div>\n\n\n\n
Enter the virtual environment and test.<\/h3>\n\n\n\n
Example of commands and outputs:<\/p>\n\n\n\n
$ pipenv shell # Enter the virtual env.\n$ t # alias of the time command\n(Output of the time command appears here.)\n\n$ echo $HW\nHello, World!<\/code><\/pre><\/div>\n\n\n\n
Exit from the virtual environment and test.<\/h3>\n\n\n\n
Example of commands and outputs:<\/p>\n\n\n\n
$ exit # or ctrl + D to exit.\n$ t\nzsh: command not found: t\n\n$echo $HW\n\n(An empty line appears here.)<\/code><\/pre><\/div>\n\n\n\n
Note<\/h3>\n\n\n\n
If projects to be published on GitHub, etc., be sure to add .zshrc.local<\/code> to .gitignore<\/code>.<\/p>\n\n\n\n
Similar method for venv<\/h2>\n\n\n\n
The most popular virtual environment tool venv<\/code> does not load a new shell. Therefore, similar functionality needs to be implemented through alternative means.<\/p>\n\n\n\n
Add the below to the bottom of bin\/activate<\/code> in your venv<\/code> directory. That’s the same thing as added to the ~\/.zshrc<\/code> in the above.<\/p>\n\n\n\n
# Load .zshrc.local if it exists in the current directory.\n[[ -f .zshrc.local ]] && source .zshrc.local<\/code><\/pre><\/div>\n\n\n\n
It involves one more step than using pipenv<\/code>, but this allows you to do roughly the same thing.<\/p>\n\n\n\n
Difference with venv<\/h3>\n\n\n\n
This method for venv<\/code> won’t load a new shell but .zshrc.local<\/code>, so applied aliases and exports are still valid even after exiting by deactivate<\/code>. Maybe you better close terminal session to avoid potential conflicts.<\/p>\n\n\n\n
Why I needed this<\/h2>\n\n\n\n
Recently, I run mlx-lm.server<\/code> to use the MLX version of LLMs. Unlike Ollama, it often happens that the memory is not released (the memory pressure remains high). So, I have no choice but to stop it with Ctrl + C each time and restart the server from the CLI. However, I felt stressed because I couldn’t immediately re-execute it by a single push of the up arrow key when I was entering commands in another terminal window. That’s why I thought about creating an alias<\/code> that is only valid in the pipenv<\/code> environment.<\/p>\n\n\n\n
I couldn’t find the solution as easily as I thought on the web, but after consulting with local QwQ, Qwen3, and ChatGPT, I eventually figured it out by myself. When I asked each LLM for their evaluation, they praised me with “Great!” and made me happy. It was the motivation of this blog post. haha!<\/p>\n\n\n\n
Image by Stable Diffusion (Mochi Diffusion)<\/summary>\n
I couldn’t imagine what kind of image would go well with this post, so I just got a showroom with various bicycles generated. Still not sure if the image is a good match.<\/p>\n\n\n\n
Date:
2025-6-14 19:47:15<\/p>\n\n\n\n
Model:
realisticVision-v51VAE_original_768x512_cn<\/p>\n\n\n\n
Size:
768 x 512<\/p>\n\n\n\n
Include in Image:
showroom with different types of bycicles<\/p>\n\n\n\n
Exclude from Image:<\/p>\n\n\n\n
Seed:
1251791658<\/p>\n\n\n\n
Steps:
20<\/p>\n\n\n\n
Guidance Scale:
20.0<\/p>\n\n\n\n
Scheduler:
DPM-Solver++<\/p>\n\n\n\n
ML Compute Unit:
CPU & GPU<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":"
This article explains a method to automatically load a configuration file (like .zshrc) containing aliases and … <\/p>\n
Continue reading “Apply local aliases and exports in pipenv\/Python”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":2467,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_locale":"en_US","_original_post":"https:\/\/blog.peddals.com\/?p=2458","footnotes":""},"categories":[8,4,21],"tags":[17],"class_list":["post-2471","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-macos","category-python","category-ubuntu","tag-cli","en-US"],"yoast_head":"\nApply local aliases and exports in pipenv\/Python | Peddals Blog<\/title>\n<meta name=\"description\" content=\"Set up and auto-load pipenv-specific aliases, exports, etc.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Apply local aliases and exports in pipenv\/Python | Peddals Blog\" \/>\n<meta property=\"og:description\" content=\"Set up and auto-load pipenv-specific aliases, exports, etc.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/\" \/>\n<meta property=\"og:site_name\" content=\"Peddals Blog\" \/>\n<meta property=\"article:published_time\" content=\"2025-06-16T15:01:29+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/blog.peddals.com\/wp-content\/uploads\/2025\/06\/showroom-with-different-types-of-bycicles.545.1251791658.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"768\" \/>\n\t<meta property=\"og:image:height\" content=\"512\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Handsome\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Handsome\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/\"},\"author\":{\"name\":\"Handsome\",\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/#\\\/schema\\\/person\\\/81b2dabca748c3d11a45722f02d9d994\"},\"headline\":\"Apply local aliases and exports in pipenv\\\/Python\",\"datePublished\":\"2025-06-16T15:01:29+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/\"},\"wordCount\":589,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/#\\\/schema\\\/person\\\/81b2dabca748c3d11a45722f02d9d994\"},\"image\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/blog.peddals.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/showroom-with-different-types-of-bycicles.545.1251791658.jpg\",\"keywords\":[\"CLI\"],\"articleSection\":[\"macOS\",\"Python\",\"Ubuntu\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/\",\"url\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/\",\"name\":\"Apply local aliases and exports in pipenv\\\/Python | Peddals Blog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/blog.peddals.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/showroom-with-different-types-of-bycicles.545.1251791658.jpg\",\"datePublished\":\"2025-06-16T15:01:29+00:00\",\"description\":\"Set up and auto-load pipenv-specific aliases, exports, etc.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#primaryimage\",\"url\":\"https:\\\/\\\/blog.peddals.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/showroom-with-different-types-of-bycicles.545.1251791658.jpg\",\"contentUrl\":\"https:\\\/\\\/blog.peddals.com\\\/wp-content\\\/uploads\\\/2025\\\/06\\\/showroom-with-different-types-of-bycicles.545.1251791658.jpg\",\"width\":768,\"height\":512},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/en\\\/load-local-zshrc-in-pipenv\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u30db\u30fc\u30e0\",\"item\":\"https:\\\/\\\/blog.peddals.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Apply local aliases and exports in pipenv\\\/Python\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/#website\",\"url\":\"https:\\\/\\\/blog.peddals.com\\\/\",\"name\":\"Peddals Blog\",\"description\":\"AI, LLM, Python, Mac, Pythonista3, iOS, etc. in Japanese and English\",\"publisher\":{\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/#\\\/schema\\\/person\\\/81b2dabca748c3d11a45722f02d9d994\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/blog.peddals.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\\\/\\\/blog.peddals.com\\\/#\\\/schema\\\/person\\\/81b2dabca748c3d11a45722f02d9d994\",\"name\":\"Handsome\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g\",\"caption\":\"Handsome\"},\"logo\":{\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Apply local aliases and exports in pipenv\/Python | Peddals Blog","description":"Set up and auto-load pipenv-specific aliases, exports, etc.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/","og_locale":"en_US","og_type":"article","og_title":"Apply local aliases and exports in pipenv\/Python | Peddals Blog","og_description":"Set up and auto-load pipenv-specific aliases, exports, etc.","og_url":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/","og_site_name":"Peddals Blog","article_published_time":"2025-06-16T15:01:29+00:00","og_image":[{"width":768,"height":512,"url":"https:\/\/blog.peddals.com\/wp-content\/uploads\/2025\/06\/showroom-with-different-types-of-bycicles.545.1251791658.jpg","type":"image\/jpeg"}],"author":"Handsome","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Handsome","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#article","isPartOf":{"@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/"},"author":{"name":"Handsome","@id":"https:\/\/blog.peddals.com\/#\/schema\/person\/81b2dabca748c3d11a45722f02d9d994"},"headline":"Apply local aliases and exports in pipenv\/Python","datePublished":"2025-06-16T15:01:29+00:00","mainEntityOfPage":{"@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/"},"wordCount":589,"commentCount":0,"publisher":{"@id":"https:\/\/blog.peddals.com\/#\/schema\/person\/81b2dabca748c3d11a45722f02d9d994"},"image":{"@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#primaryimage"},"thumbnailUrl":"https:\/\/blog.peddals.com\/wp-content\/uploads\/2025\/06\/showroom-with-different-types-of-bycicles.545.1251791658.jpg","keywords":["CLI"],"articleSection":["macOS","Python","Ubuntu"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/","url":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/","name":"Apply local aliases and exports in pipenv\/Python | Peddals Blog","isPartOf":{"@id":"https:\/\/blog.peddals.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#primaryimage"},"image":{"@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#primaryimage"},"thumbnailUrl":"https:\/\/blog.peddals.com\/wp-content\/uploads\/2025\/06\/showroom-with-different-types-of-bycicles.545.1251791658.jpg","datePublished":"2025-06-16T15:01:29+00:00","description":"Set up and auto-load pipenv-specific aliases, exports, etc.","breadcrumb":{"@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#primaryimage","url":"https:\/\/blog.peddals.com\/wp-content\/uploads\/2025\/06\/showroom-with-different-types-of-bycicles.545.1251791658.jpg","contentUrl":"https:\/\/blog.peddals.com\/wp-content\/uploads\/2025\/06\/showroom-with-different-types-of-bycicles.545.1251791658.jpg","width":768,"height":512},{"@type":"BreadcrumbList","@id":"https:\/\/blog.peddals.com\/en\/load-local-zshrc-in-pipenv\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u30db\u30fc\u30e0","item":"https:\/\/blog.peddals.com\/"},{"@type":"ListItem","position":2,"name":"Apply local aliases and exports in pipenv\/Python"}]},{"@type":"WebSite","@id":"https:\/\/blog.peddals.com\/#website","url":"https:\/\/blog.peddals.com\/","name":"Peddals Blog","description":"AI, LLM, Python, Mac, Pythonista3, iOS, etc. in Japanese and English","publisher":{"@id":"https:\/\/blog.peddals.com\/#\/schema\/person\/81b2dabca748c3d11a45722f02d9d994"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.peddals.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/blog.peddals.com\/#\/schema\/person\/81b2dabca748c3d11a45722f02d9d994","name":"Handsome","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g","caption":"Handsome"},"logo":{"@id":"https:\/\/secure.gravatar.com\/avatar\/51d7363349ec538c4d62c9ebe89488fd7388729ad0c9dfeebd8bb32ebfb11f17?s=96&d=mm&r=g"}}]}},"_links":{"self":[{"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/posts\/2471","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/comments?post=2471"}],"version-history":[{"count":16,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/posts\/2471\/revisions"}],"predecessor-version":[{"id":2487,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/posts\/2471\/revisions\/2487"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/media\/2467"}],"wp:attachment":[{"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/media?parent=2471"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/categories?post=2471"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.peddals.com\/wp-json\/wp\/v2\/tags?post=2471"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}