diff --git a/README b/README
line changes: +18/-0
index ca690d9..27c0e5f
--- a/README
+++ b/README

@@ -1,3 +1,21 @@
+Requirements:
+
+Most of AwesomeGrid will work as-is.  User manipulation (ag-useradd,
+ag-userdel, ag-listusers, ag-flush) and integration (ag-update-shadow,
+ag-update-openbsd) will work without extra modules.  To change passwords
+(ag-passwd), you will need Crypt::PasswdMD5 (for Linux and FreeBSD),
+Digest::SHA1 (for OS X 10.4+), and Crypt::Eksblowfish::Bcrypt (for
+OpenBSD).
+
+Please note that while ag-passwd generates what is believed to be a
+proper OS X-compatible SHA1 hash, it has not been tested, and there is
+currently no tool to integrate it with the OS X user database.  If you'd
+like to create such a beast, we'd love your contribution. :)
+
+Utilities to securely pack and unpack user information (ag-import,
+ag-export, ag-keyring) require gpg of some recent vintage.  I'm using
+gpg 2, but it may work with gpg 1 or pgp for all I know.
+
 To install:
 
 $ ./install.pl